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Bring your Amiga to 




AMOS — The Creator is like nothing you've ever seen before on the Amiga. If you want to 
harness the hidden power of your Amiga, then AMOS is for you! 
AMOS Basic is a sophisticated development language with more than 500 different 
commands to produce the results you want with the minimum of effort. This special 
version of AMOS has been created to perfectly meet the needs of American Amiga owners. 
It includes clearer and brighter graphics than ever before, and a specially adapted screen 
size (NTSC). 



M Whether you are a budding Amiga programmer who wants to create fancy graphics 
without weeks of typing, or a seasoned veteran who wants to build a graphic user 
interface with the minimum of fuss and link with C routines, AMOS is ideal for you. » 
Amaiing Computing. June 1992 
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► Define and animate hardware and software sprites (bobs) with lightning 
speed 

► Display up to eight screens on your TV at once - each with its own color 
palette and resolution (including HAM. interlace, half-brite and dual 
playfield modes) 

^ Scroll a screen with ease. Create multMevel parallax scrolling by 
overlapping different screens - perfect for scrolling shoot-em-ups 

► Use the unique AMOS Animation Language to create complex animation 
sequences for sprites, bobs or screens which work on interrupt 

^ Play Soundtracker, Sonix or GMC (Games Music Creator) tunes or IFF 
samples on interrupt to bring your programs vividly to life 

► Use commands like RAINBOW and COPPER MOVE to create fabulous 
color bars like the very best demos 

► Transfer STOS programs to your Amiga and quickly get them working like 
the original 

► Use AMOS on any Amiga from an A500 with a single drive to the very 
latest model with hard disc 



M/UAT Vnil PFT AM0S Basic " sprile editor ' Ma £' c Forest and Amosteroids 
Iff llrtl I VU ULl arcade games, Castle Amos graphical adventure. Number 

Leap educational game, 400-page manual with more than 80 example programs on disc, 

sample tunes, sprite files and registration card. 

If you've got an Amiga you need AMOS! 



For help you can phone the special US SUPPORT LINE on 219 874 6380 
Alternatively you can access the special BBS line to ON-SCREEN HELP on 

219 874 0367 
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printf ("Hello") ; 



print "Hello" 



JSR printMsg 



say "Hello" 



writeln( "Hello") 
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Startup-Sequence 



Development 

magazine was originally created for the high end 
user and developer. So far, it has been successful in reaching 
its intended audience. I want to improve on thai primary goal 
by setting a new agenda for ACs TECH. 

n be frustrating at times to watch the Amiga 
market Vmi sales could aJ w a v ■-• h g b ei I er Produ c I d eveJt ip 
meni i anti tin computer communm '-• 

d the Amiga is often negative. The Amiga itself 
i> a good platform. And like any other computer, with the right 
combination of hardware, software, and ingenuity, it can 

:'.e the perfect machine for whatever task it is asked to 
perform. 

Further research and develop men 1 is needed to 
ad van> «• tin- Amiga and make it a leading platform in the 
1990/5, Hardware and software development need to comple- 
ment each other, The Amiga has a lot of potential. The boom in 
video development has proven jjusfl that There are, however, a 
great deal of Amiga users who do not use their Arnigas for 

production. The development community must address 
the game players, desktop publishers, and home and business 
productivity people as well as the video users, 

I don't want this editorial to come across as one of 
those "feel-good-hail- Amiga" pieces. The readers of this 
magazine already have reasons to like or dislike their Arnigas 
and don't need me to play salesperson. Instead, my aim is to 
motivate the Amiga programmer, developer, and software 
publisher into creating higher quality software tat this 
machine We cannot wail tor Microsoft or Aldus to port theil 
ids o\ er lo the Amiga. Therefore, we have no option but 
to develop equal or belter products. This is not to say that the 
soft ware available at this time is below standard—it's not. But 
there is always room for improvement. 

ACs TECH should be used as a venue for new 
development k\> 

I am going to ask thai '^m send us an) suggestions 
lor articles which you would like to see, Also, if you have an 
article vou were thinking ot n riting for us, please go ahead 
and do so, I want you to sit down at vour Amiga and write 
code that will blow away anything created before it. Think of a 



problem with your favorite piece of Amiga software and find a 
solution to it. If the solution is to generate a new piece of 
software, then by all means, create it. The more development, 
the more products. The more products, the higher the competi- 
tion. The higher the competition, the higher the quality, I ligh 
quality software and hardware is what we all want and need. 

Take the initiative and start those creative juices 
flowing. 

Submissions 

We receive hundreds of submissions for AC'S TECH 
throughout the year, They are all well written and informative,, 
but unfortunately we I annoi publish all of them. Therefore, we 
look for the strongest articles i s that will bring the 

most benefit to our readers, If you choose to send an article to 
us, make sure it will stand out from the rest Present a well 

n, informative, interesting, and beneficial article. Give 
the reader a reason to purchase the magazine and read your 
article. We also need small utilities to include on the ACs 
TECH disk. If you have something, send your program and all 
necej 9 along with 1-2 pages of documentation to our 

submissions department. 

Part of the new agenda for AC a TECH will be to 
spark an interest in creating software and hardware for the 
Amiga. The magazi n en directed at the high-end user. It 

will continue to fulfill the ne> high-end user, program- 

mer, and developer We will also start to nourish the creativity 
ot those of us who do not have a great deal of development 
experience, High-level users must grow from beginners. I want 
AC's TECH to be used as a tool, A tool for learning, A tool for 
development. A tool for creativity. 

Together we can improve the quality of computing 
life for all Amiga users. 




Jeff Gamble 
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Putting 

the 

Input 

Device 

to 

Work 



by David A. Blnckwell 



introduction 

Almost every program require si fi nput and 

'Hi, Programs thai are totally self-contained, lacking any form ol 
interaction, are exceptional!) I -".Ting and prune to quick obsolescence, 
In fact, I am unable lo think of any programs off hand lhat do not I i- 1 
some form of input or output, regardless of the source of input or the 
destination of the oul put. 

On the Amiga, your input and output options are very 
flexible. You can choose from more than a dozen way* to perform I/O 
the Amiga operating system and hardware. The type of program 
you design determines the I/O methods best suited for your purposes. 
If you are writing a program thai you want to be compatible with 
future reftesjei of the Amiga operating system and hardware, you will 
select 1! icceptabk I fO methods. If you are not concerned 

with future compatibility with system >.ofUN jm .i h.udv\ are, you can 

methods that perhaps even include direct access to \ a 
hardware registers. Our focus in this article will be basic user in] 
and output using the lowest level of system acceptable I/O — The 
input device, 

Comparison 

fore describing how to write your own input device 
handler, we should compare the three acceptable I/O methods for 
aw input and output. You will be better prepared to choose 
which I/O method, or collection of methods, is best for you after 
reading this comparison, We will start with the Console Do 

Console Device 

During normal system operation, the console device is 
situated ai the top of the input event food chain. Essentially, what this 
means is that the console device gets all the input scraps What the 
other users (handlers) of the input event chain don't consume gets 
passed to the console (fori J our window is the active 

window, and the console device is your only source of input and 
output, you will receive |ust about any input event you desire. On the 
other hand, if you have more sources of input than |ust the console 
device, vtiur console device can be completely shut oul by the other 

es. That could be your design though, and you may be planning 
the console device simply tor it output capabilities 

The real strength of the console device lies in its output 

IlitJes. The console device has the most e>.i of text 

oriented output commands of the three acceptable I/O method 
will most likely choose the console device if you need total control of 
the screen text display, The I/O process is somewhat involved, 
howet '. r and requires a lot of messages be passed between the 
program and the Console Device. You use messages to request input 
.ss ',s«.'ll u perform output On the other hand, the easiest type ol input 
method has b i K- Intuition using the Intuition Direct Communications 
rort(lDCMP). 

IDCMP 

Using an IDCMP is the easiest way to connect your program 
to the input event stream Intuition does most of the setup work for 

i tuition knows you want it to setup an [DCMF for you when the 
IDCMPFlags field of the New Window structure is not MULL Intuition 
will then automatically create a message port for you. You spei ' 
which input events you want to receive by selecting the appropriate 
IDCMP Hag bits (List One contains the tl K. MP flags). 



4 AC'S TECH 



This is jus* a brief ii on to the IDCMP. For a complete 

description of hov. to £el the II H Ml' to work tor you, read "Program- 

he Amiga's GUI* in C"b) PaulCasto -VC'VIEC H 

volume 3, number 3. He does .1 \ crj thorough job and has promised to 
continue with more insight Into the ID 

The main drawback, of using an II X. Ml' is the lad '--l output 

An I IX i I/O. You will 

most likely use i he console device, graphics library or a contbuu I 

1 you need to output anything. Pox detailed text control 

notions and draw in^ 
mages and lines on the window you use the graphics library In: 
passes any input event-, 1h.1t 11 da dtc the console.: 

however, it 1 El input from the input device. 

Inpul Device 

As I stated earlier, the input device is tin- lowest level of 
acceptable system inpul and output . Hv this 1 mt 

from the inpul d 
The input device, however, is not the absolutely lowest level of system 
I/O. The input device >m the keyboard, timer and 

gameport devices Asprogramn rest level of I/O 

-n mended for us is the input device. So, to use ih 
programming parlance, the keyboard, timer and gamepnri devices are 

"feeders" of the input device, and Intuition and the console del H E BK 
" uset of the output ol the input device (no pun 

intended). 

I landlers ol the input-stream — output ol the input device 
— can be at different le\ 1 1 within the Input-stream I hesc various 
levels, also called priority p , . nge f rom - ] 28 to * 1 27. The 

higher pi ;mi iv, handle] 1 to 1lie source of the input Intuition is 

at position 50, and the console device is at position 0. That shows why 
Intuition gets first pick .it the input events ind the console de\ i 
■vers. 

V- Us name implies, the input device is mostly user 
receiving input; however, it can be used 10 generate output \ .1 
method of output though, it is quite inefficient You perform output by 
allocating Input Event stris. each character you want output. 

Then \ on I'h.n t io allocate an U IStdReq structure You pass the 
lOSidkeu sirut lure to the input dw ict requesting '• '" sdd Ihi 
InputEvent structures to the input -stream You can see that this is a 

v method of output. like with the IDC Ml', you wont. I 
likely use th. lev ice or the graphics library to handle your 

output 

Unlike using an IDCMP or the console device, you are not 
required tn have a window to receive input from the input di 
With le console device, not only must you have a 

iv imdow, b ut your window m usl be the cum - ■ window in 

order!" Ipul 

This u ' he input tie', ice Is extremely useful II 

you want your program to be able to manipulate oth= such 

as perform j|e1 j | x operations. Your window cm go Io the 

back while activating othf Then by monitoring the input- 

stfeam ft* specific key strokes, you can perform opera) 
window in the system Another possibility is dosing your window 
completely and al! -nr program Io steep in the background. 

Then you wait lor a special combination of keys to be pressed, By 

and you reduce the workload on the CPU. When y r our special key 
combination is pressed, your program comes back to li 
display win I • input from the 1 



These brief descriptions of the three methods of basic system 
I/O should help you determine which method is what you need. Now 
we are going to takes I tiled look at the input device and the 

to ut* use 
Let's Get Started 

The input device is just like any other device in the Amiga 
operating system, You must open it b .in use it You send 1/ 

O requests to il to perform various functions. When you are finished 
. the input device, you must close it 

Two steps j re required before calling the Open DeviceO 
function to open the input device; create a message port that the input 
device can use ss .1 reply port, create the necessary structures to p tss 

commands and data to the input device. Io use the input de\ ice 
effectively you will have to be familiar with several structures the 
inpul lie \ Ice uses to do lis processing. 

The lOStdReq and timerequest structures are used to pass 
commands and data to the inpul device. The Input dev ice recognizes 
tour ol the nine standard Exec commands and eight device specific 
commands (List Two contains the complete list of input de 
command-i | he M IStdReq structure is used for the majority of the 
command', while the timerequest structure is used for the 
IMJ SKITH KESH and IND.SETPERIOD command*. I include a short 
description of each command in the InputDevice.h header tile 

You use the CreateExtlOf ) function to allocate the structures 
mentioned above- The arguments of this function include the message 
port address of the reply port and the size uf the structure to be 
allocated. The following two example lines of code will allocate an 
lOStdReq structure and I timerequest structure. 

CroaceExi ;:<*Gt Struct IOStdReql I r 

• ■act 101 Reply v- \ timerequ- 

1 check to make sure I he CreateExtlOf.) 
I ion does not return an error. Once this structure is aUocati 
can open the input device. The following function call will accomplish 

■ 

re". NULL. lORecjuest, NULL); 

1 \ ULL represents a device number. This will almost sta 
NULL unless you are using the trackdisk or timer device, The 
I lOStdReq or timerequest structure that you 
previously allocated. The lasi NL1 1 represents flag bits. The flag bits 
indicate options foi some -h". ices, The input device does not sccept 
in this manner so th 1 to NULL. A zero return 

from the OpcnDeviceO function indicates success. The last structure 
you need Io be aware of is the InpulE% f ent structure. 

The main structure that the input device uses to pass 
information in n . is the InputEvent structure. The 

input el. structure to pass information on 

keypresses, mous gadget events, etc down the input- 

When you are done using the input device you close it. To 
do this yon call the ExecC loseDev i'. ei) function passing a pointer to a 
lOStdReq Off timerequest structure as an argument. This will be the 

iructurethal you used to open the de 
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I jusl lightly touched on using the inpul device in (his 
manner. Our main emphasis in this article is writing our own input 
handler. 

Input Handler 

At first, wh.it may appeal to be a daunting task turns out to 
be surprisingly simple; as long as you know assembly language. 
Because ever) dock cycle your Inpm Handler uses reduces mc 
remaining time before the next event happens, ] highly recommend 
ou write your handler in assembly language. 

The AC lech articles written by William P. Nee covering 
assembly language are worthwhile to lead if you br unfamiliar with 
assembly language programming. I also recommend Motorola's book 
on the 68000 series or i bssdis i published by Prentice Hall). 

This book contains the execution tmi , 6000 instruction set to 

help you write the quickest code Ml hough this book contains a 
complete listing of the instruction sets of various 68000 series n 
processors, it does not teach assembly language programming, When 
writing your handler code, you will need to know what you will be 
receiving .is input. 

When you r hand ler is called , a dd re - ■ ids a 

pointer to a linked list of input events, and address register Al holds a 
pointer to your handler's data area, 1 rn ( ['I has eight address 
registers (AQ-A7}, six of which are available tor youi program to use 
(A0-A5). Register A6 holds the base address of the shared library you 
are currently using, and register A7 holds the stack pointer. The I 
input events Is t single-linked list. This means you can only go through 
it in one direction, and when the pointer to the next event is \t I I . 
you have reached the end. 

Your handler's data area is whatever you want it to be. In 
the example program, I use this data area to pass information to my 
handler that it will need to operate. I also use this area to communicate 
with my handler from my C program. Before the input device Can tell 
your handler where this data area is, you must first tell the input 
de'. :i r e. hrre il e. 

You will pass the address of your data area in an Interrupt 
structure. This structure will also hold the entry address to your 
handler code. I will go into this in greater der.nl bier in the article For 
now we will get back to writing our handler. 

Since ad. iters A0 and Al are scratch registers, and 

their values can be changed by any system routine you might call, it Is 
a good idea to find a safe place to put (he values passed in them. In my 
code, I stem, A3 and A3, for this task. 

Since ,: ben are not scratch registers. I had lo save their values 

i ould restore them when my handler was done. I use 
the rol die to handle 



rm -.• - . 
now i, 

movea . 



aves non-scratch registers 

xit event list pointer in A2 

r data pointer in A3 



9 hold the pointer to the current inputevenl structure I am 
working on and A3 holds the pointer to my data area throughout the 
execution of my handler. 

pointer values, it is easy to scot - 
particular t d by using the indexed indirect addressing mode. 

This is similar to the pointer addressing used I"". I Nil example will 
help illustrate thi- point. In C, I would use the statement 

size « 20; 

to assign the value 20 to the hd_msgsi/.e field in the my Data structure. 
In assembly language 



would do the same thing. The C pointer variable my Data and the 
addr. i A3 hold the starting address to the block of memory 

I i presents the structure that ho! 1 1 area for my handler. 

The hdjmsgsise offset value is added to the pointer address to make it 
point to the proper location in memorv to store the given value, The C 
structure member hd_msgsi7e and the assembler constant hd_m 

■ ll the same label. Although they look exactly alike and ad 
represent the sain due, they are given their respective values 

at two different locations in the program, The C preprocessor assigns 
the offset value to the hd msgsize structure member when tt encoun- 
ters the structure definition. 

Struct my Hand ler Data ( 
struct MsgPort ' 
tlLONG hdLmegeJ esj 
ULONG hd_jwsnreqs; 
ULQrJG bd_passe vents; 



in the Input Dev ice. h header file. The assembly language constant 

ea its value when the assembler encounters the assembler 
directive, 

hdJBSffsize equ $0*. 

in the InputDevice-i header file, If you look in the [nputDeviceJ header 
hie, you will notice other assembly language constants thai look 

uy tike their C la n i mterparts. I named them that w a j lot 

consistency. In your own program you can use any names you wish, 
Besides the recommendation to write your handler in assembly 
language for speed, there are other rules that you need to be aw ore ol 
while writing your handler code, 

Handler Rules 

I ler may allocate menu n ] h i uh ll I I ummunicah.' 
another program through a message port or to use to add new 
events to the linked list it passes to lower priority handler-- It CM 
actually allocate memory for any purpose U wants hut these are the 
most common uses. 

Allocating memory for messages and copying inforn 
from the inputevent structures in the linked list is pr efe r red to having 
row handler do the processing of the input events you are looking for. 
\ qui handles should request ■ bin It dI memory the size you need b\ 
using the Exec AllocMemQ function. This can be done with the 
following code: 

move, i hcUnsgsize(A3| , DO ; size of message structure 
move.l r>dLrrwTireqstA3),Dl ;reqv*"-- -jar memory 

:9B(A6> lAtlocMernlsize, requirements* 
movea .3 D0,A1 ;put address of allocated; nor; 



A. 



tst.l 00 ;see if 1 actually received seme memory 



In the first two statements I am setting up lo make the call to 
the AllocMemf) function. I determined which registers whi 
this function by looking in the Exec pragma rUe lhat came in the 
include files with my C compiler. Then I looked at the function 
prototype to see e each register represented. The third 

statement alls the AllocMemf J function. 

When your handler code is Billed, the A6 register holds the 
base address of the Exec shared library, You can access any Exec 
function by providing the correct negative offset from this base 
address. Again I looked in the Exec pragma file to obtain this offset It 
is given as a hexadecimal number right before the function name. In 
mis case the i slue was given as 0xC6. 1 took this value and converted 
it to a decimal value, Then I put a negative sign in front of the decimal 
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number and thus I had the proper negative offset for Ihe AllocMemf.) 
function. 

The very next statement after my call \0 tliOCab 
rv puis ihe returned memory 1 address in the A I Address register. 
At this point you may be wondering how I knew the ad< 
allocated memon v, DO. This Is very simple. In 

the Amiga operating system, any function that returns a value, returns 
that value in the DO data register. Again, the CPU has eight data 
register* (DD-D7) and all eight in available for your use- How. 
only ' : ters DO and D1 are considered scratch registers- If vou 

use any of the other data registers bi your code, you should 
save their values on the stack at the beginning of your routine so you 
can restore their values when your routine 

As with any olhei routine; Ihe AllocMem() function may not 
be able to accomplish your request successfully- That is why the fourth 
statement in the example above tests the contents of the DO register 
h ith the bttJ instruction Phis is an easy way to test fora NULL value 
which m this case would signify an error. Thi-s instruction is normally 
followed by a branching instruction to handle an error condition. 

After I am sure I have my message memory, I copy the 
information I need from the inputevent structure into my message 
structure, and I send the message to mv awaiting C program, I used 
•I i I Kec PutMsgO function to send Ihe message. Again I used the 
function pragma and protol ister usage and proper 

negative offset from the E nee base address In my C program, 1 process 
the message utd bee the message memory when I am done with it, 
This is the method you should also use. Tin ing load would 

slow the input handler down to an unacceptable speed and would 
slow the entire system down to a craw], That is generally not a good 
idea. 

t some additional processing, I check to see if there 15 
another inputevent structure to process It so. I go back to allocate 
some more memory and send another message It not, I restore the 
t slues of any no d data registers I may have used 

and then exit. My code that does this is as follow 

move, I ie_ftext Event (A2I ,D0 ;get next event 
movea.l D0»A2 /put event structure poinl 
bne,s more ;go back if there is another event 
movem.l tspt*,A2-A3 j rest ore ncr. registers 

move.l (spl»,DO ;put event list painter in DO 
rts 

The first three instructions determine if another inputevent structure is 
there to process. Tile bne.s instruction goes back if there an 
otherwise, the handler exits. The next instruction after the 1 u 
instruction restores the values of the non-scratch registers. The next 
instruction's pucpi let may not be so clear. The very first thing I did 
when my handler was called was to save the address of the first 
inputevent structure on the stack, The output of the handli I 
supposed to be a new linked ttet in the DO d be*. Since I never 

physically remove any events from the list, I just pull the first address 
off the stack directly into the DO register and exit my handler km 

As f • fated, your handler is free to add events to 

the linked list of events also. To do this vou must also allot 

i inputevent structure. Vou then initialize the structure with the 
values vou desire and add ii to the list The next time pour handler Is 
( ailed vou are free to return the memory your inputevent structure 
used to the free memory pool or reuse it foe another input. 
important thing to remember is that your handler is responsible for 

g track of any memory allocated tot ihis purpose and eventually 
returning it to the free memory pool 

\n. ither rule Concerning inpul handlers is thai they I 
to unlink any input event in the linked list they reeeh e. In fact you are 
encour.vL.ed to unlink events because that means that you will pass a 
vr list to the Iowit priorit) handlers This speeds werall 

process of servicing the input event stream. In fact, if you remove 



every event structure and return a NL I I value in DO, the input device 
will not even call the loi» er priority handlers. I chose a slightly 
different method of ( . Instead of physical!) 

removing the event, I converted it to a NULL class of event. This action 
produces the same effect and reduces the complexity of nn handler 
code. 

That describes the rules your hand 1 1 uld follow 

and provides you with example handler code to study I would like to 
caution you on one point. Programming bugs in your handler n 
are very difficult to debug, Make iri to insure that your 

handler code is bug free before you submit it to the input device. There 
is another issue you will have to take care of first, m.ik 
code entry poin I In your C program. 

Because your handler code is written in assembly language. 
your C pru i not really have any knowledge of its existence. 

This creates a problem when you have to supply the handler entry 
address to the input device. There are two Statements you must 
include to make your C program aware of your handli nee. In 

your C code include the 

extern 

, pe, of course change the handler name to whatever you call 
your routine. Nest, in your assembly langn in of your 

program include the 

xdef _iry Event handler 

assembler directive Then make sure the _myEventhandler: label is at 
the beginning of your Kan! I he reason for the initial 

underscore character is that C appends an underscore to the beginning 
of all its variables and function names. If you didn't do it, then the 
names would not match when C assigned the underscore to the 
external mybventhandlerO function you declared in your prototype. 
[lie linker would then be unable to fill in a value ivhenevei 
referenced the function in your C code and would report an error at 
link time. Being aware of these practices of the C compiler S3 
great deal oi headaches. 

Once you have written your handler codi -emhly 

language to make it as quick as possible, and you made its entry point 
available to your C code, you are ready to add it lo Ihe btsl of input 
device handlers. Now > k working in C so this pro* 

fairly simple. 

Adding Your Handler 

The first thing you are going to do is allocate the memory tor 
the structures you are going to need Then you open the input device 
exactly as described above, In addition to the lOStdReq structure you 
will need an interrupt structure. 

You us*- Ihe Exec AUocMemf f function to get the dm 
you will use for the tnterrupt structure. In the Interrupt structure you 
are going to set up your priority, the name of vour interrupt routine, 
the pointer to tin data a rea, and the pen nter to the ent ry point 

of your handler routin ilues are placed in the is.Node.ln_Pri, 

i ■ e, is_Da ta and is_Codc fields' of the In terrupl 
structure respectively. You setup your lOStdReq structure after you 
finish with the Interrupt structure 

In the lOStdReq structure vou set up the command to pass to 
the input device — in this instance it will be the IND_ ADDHANDLER 
command — and the pointer to \ our tnterrupt structure I hese values 
are placed in the io Command and the ioJ >ata fields of the lOStdReq 
structure respectively Your set U| ill done and you are ready 

to add your input handler to the list of handlers. 

Your next action is to pass your lOStdReq structure to the 
input i : tvallabui 10 accomplish this task 

They are the Dt>IO() and ScndlQO functions. The only difference is that 

Ii t synchronously while the other operates asynchronously. 1 
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nous t unction, DolOO, because I did not want my 
im to continue until 1 was sure my I/O request had been 
completed, 

Once your I/O request has been successfully executed by ihe 
input device, your handler is hard at work processing input eve 
r hi- is fllsa where you will most likely find out if there are any bug-, in 
your handler code. Expect a quick GURU vigil If mete ace problt 
with your handler code Hopefully vou won't encounter anv problems 
and your handler will execute perfectly, 

Closing Down 

i inly point remaining fet ) mil handler 

ing property; is shutting irtant to make sure thai 

I return all Ifh I allocated to the fret- memory pool 

Your iirst , tsiness is to shul down the input 

hand If i Sinn we used global variables for ihe Interrupt and lOStdReq 
structure we used 10 jdd the input handler, they are still available for 
use. All that we need do now is change the command in the lOStdReq 
structure from 1ND ADOHANDLEF >LER. Once 

(his is done, send the lOStdReq sb im hire to the input device Once Ihe 
tnput handler is shul done you can close the inpul 

Now lo release the mem I for the 

Interrupt and lOStdReq structures. You use Ihe FreeMemO function to 
Ihe Interrupt structure memory and the DeleteExtiOfJ function 
eq structure men* 

-anv las! i our handler 

sent before being shut down you will free up any memory used by 
• ou can wan until you exil the program lo close you message 
port it you wanl to 

That pretty much outlines what you need to know to put an 
input event handler to work for you By going over the example 
program closely, you will get behYr insight into how each of the three 
I/O methods described work together You will especially see bow the 
input handler works and hens lo gel it to i ommunicale with your C 
program. 

Example Program 

I wrote Ihe example program to provide! nan 

in own input device handler. I did not really intend to teach 
assembly language programming I touched the topic a little in the 
description of the handler code, but I do expect some larniliarity with 
assembly language programming Ii is essentia] when urn begin to 

oui own handler. I believe that it is a good idea to have a 
foundation in assembly language as well as an intermediate or high 
level language. The example program, besides showing you how to 
write, install, handle daft irom and close down your own input device 
handler, shows how an input device handler can be used m conjunc- 
tion with the other I/O options available to you in the Amiga 
operating sv 

Ih a little modification, you ( in begin lo see how ihe 
different I/O ss strive- work together. In the install _in put h, 
function you can change the prn i handler. This changes your 

handler's relative position within the input-stream. This can provide 
some insight nth uuj l-.-r ( |p insert input events in the linked 

I the proper level; Tins can be done to ensure dial Ihe input event 
is processed h\ ihe handler you have it m mind for. There are vai 

lent with this example program code to explore 
different I/O setups 

Program Operation 

The example program opens a screen and a backdrop 
OW lor its display. In the top portion of the window are three 
boxes that display the inpul events received by the input di 
handler, the IDCMP and the console device. Below the display boxes 
are four gadgets. Three gadgets an labeled as Input Device Gadget, 



IDCMP Gadget and Key Type Gadget. The last gpi he QUIT 

gadget 

The first two gadgets mentioned control the Bow of 
keyboard events to the lower priority handlers. The input device 
handler defaults lo passing the events without modification. When you 
click on the gadget it changes. Then the input device will consul 

,ird events When you tell the input device handler to consume 
keyboard e* the m enl class to a NULL class. This makes 

the lower priority handlers pass over these events. 

Ihe I IX' MP gadget operates in the same manner as the 
Inpul Dsvii i pi that it defaults to consuming the keyboard 

events. The steps . wsume or pass the events are different, hut 

theoutcom UUJ. The difference between the way the inpul 

device handler passes input events and the way the IDCMP passes 
input events is that the input device handler still receives the input 
e\ ent that it later passes while ih< . vet receives il u 

You will notice ihis in the three displaj I,. run the example 

program 

The QUIT gadget is self explanatory I believe, U« tins 
gadget only when you have grown tired of seeing how the three I/O 
methods work toget I 

The last item on the i at the very 

bottom, Hopeful^ vou will not get to see Ihis function inaction 
area is on I y used to report problems en I wh i le the program is 

running. 

Conclusion 

The example program contain* much more useful informa- 
tion within its code than I was able to put into writing in thi- article I 
recommend that you look over the code to see how its work 
always I hope that this program helps you gain experience with an 
aspect of the Amiga's opera ' i were unfa mi I i a r with , 

I enjoy receiving your comments, recommendation'* and sv 
For those readers who subscribe to ( lEnie vou can send me 
comments using the e-mail address, D.Blackwelll . 








it source code and executable files 
>r this article may be found on the AC's 
TECH disk 



Please write to: 

David BJackiivll 
c/o Amazing Computing 

P.O Box 2140 
Fall River. MA 02722 
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In Search of... 
the Lost Window 



by Phil Burk 



The windows on the computer screen were designed 
i inu late the papers on our desk. This metaphor 
works very n ell,, bu1 Is sometimes too close to reality. 
Documents, letters, note$, and program listing 
accumulate until I feel like .in an liaeologfct excavating the 
layers of an ant tent civilization whenever I try to find some- 
thing on my desk lean date a document by how many inches 

Ulied below the top surface 

Mv Amiga's Workbench can also become cluttered 
when I li.ne several programs running, each with multiple 
windows, 1 became tired of sifting through these windows 

the push-back gadget-, so I wrote a simple program called 
FindWindow, With this program, 1 can now get to an) window 
on the Workbench with one simple action. I thought it would 
be marginally useful, so I gave it to a few friends. Much to my 
surprise, they use it constantly, and it has earned a permanent 

m their Workbench screens. FindWindow opens a very 
small window that usually sits in the Workbench title bar. 
When you click on the window with the left mouse button, a 
popup menu appears h Ith a list ol all open Workbench 
'.ymilKhvs You can select a window which will pop to the front 
and be activated. Seta ting from a popup menu using the left 
mousebutton may seem strange at first I chose it because 
using the rijgfcl button would require two mouse actions — one 
utton to activate the small window and a second 
action with the right button to use the menu, 

|~he program was written using }Ft>rth Professional 
Version ! available from Delta Research If you are program- 
ming in C or any other fine language, I trust the principles in 
this program can be applied to \ OUT own work. 

ONE-MINUTE FORTH LESSON 

is a quick Forth lesson to help you read and 
understand the program listing Forth has a large dictionary of 
commands called "words." Forth words typically operate 
stat k ol (lumbers I or example, the plus operator • removes 



the top two numbers from the -t.u k, adds them together, and 
places the sum on the stack. The print operator '.', pronounced 
"dot/' removes the top number from the slack and prints it. 
Comments are in parentheses. For example; 

1 would print 323 ) 

is -vstem is called Reverse Polish Notation, at 
\W\ It is the style used In I IP calculators. It may seem a bit 
odd at first, but is quite easy to learn because everything 
happens in a simple left to right order 

To define a new word and add it to the dictionary. 
Forth uses a colon ';', followed by the name of the new word. A 
"stack diagram" usually follows that describes what is 
expected on the stack and what is left after execution. A stack 
diagram that uses curly brackets '{' defines local variables 
similar to C. The word definition is ended with a semicolon, 

sample, net d SUMSQ that uses local 

variables and calculates the sum of the squares ol two input 
values, 

. calc sun of squares ) 
a a ' 'Iculate square of A > 

bb' ( square B, both squares are on : : 

nunbers on sta< • 
t-ould be tested by entering: 

3 4 SUNS'. 



PROGRAM OVERVIEW 

Now let's dig into the FindWindow program and see 

how it works, 1 lere is a pseudo-code description of the 
program: 

Read \,y and color parameters from command line. 
Open small window and draw buttons 
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Wail for mouse events. 

If mouse button pressed in "Windows" box then 
Scan Window List for Window tides, 
Open Popup Menu with lilies. 
Wait for Mouse up to select window, 

ectd window to front and activate, 
dose Popup Menu. 

If mouse button pressed in dose box then 
Close window and exit. 

The small window contains three buttons, a close box, 
an about box, and a button for the popup menu, 1 did not use 
Intuition Gadgets for these because I could tell which button 
v, ashjl simply by looking at the X-position of the mouse, 
gets are worth using for more complex applications, but 
L'hnique often provides a simpler solution. The code that 
anahves the Vposirion is in the word FW.PROCESS in 
Find_Window,f. 

Most of the program is fairly straightforward and can 
red Irom the comments. Then' an two 
however, which need some explanation; scanning the win- 
tor their titles, and the popup menu. 

GETTING THE WINDOW TITLES 

The most important trick in Find Window is getting 
the titles of all the open windows. On the Amiga, the first place 
to look for information is usually in the Library Base struc- 
ture When you open a library you get an address to a Library 
Base structure Below this address in memory are the jumps to 
the various functions in the library Above this address is a 
structure which contains lots of information used by the 
library. 

In the Intuition Library, there is a pointer to the 
Active Screen. Siru e H e will be using the Workbench, that will 
be the Every screen has a pointer to its first 

window Each window has a pointer to the next window in the 
screen. Here is a summary- of what points to what: 



t lanBase 



-'■• FirstWindow -> Next window 



Let's use J Forth to interactively expli struc- 

tures. I his is i 'tten the way a JForth programmer will work, 
First figure out how the Amiga works by interactively experi- 
menting. Once the technique is understood, then it is time to 
write the code. If you have JForth, fire it up. If not. follow 
along and we'll explain things as we go. 

I irsl we should compile some tools to help us, 
i'_STRUCT will print the names and contents of the 
members of a structure VALUE is ■ handy type of variable. 
Enter tn JForth: 

includ inp struct include- 

After 2 or 3 seconds, JForth will print how many bytes were 

^dded to the dictionary Now let's attach the precompiled 
include files that contain the Amiga structure definitions 
Enter 



geOnodule 

To open the Intuition library in JForth, we can use 
INTUITION?, This will place the f the Intuit ion Base 

in a variable called INTU1T10N_LIB. We can fetch the 
address using © then dedare a value called I BASE that we can 
use to refer to the structure by name. Enter in JForth: 






intuition lib S >rel value IBASE 



I BASE conta ins the add i he I ntu i tion Base 

str hi ture. To dump out the contents of the IntuitionBase, enter: 



Lbam 



Here is a partial listing of the result 














3 


IB F 




U4 











i ice that the Mouse X,Y-position is stored in this 
structure. Just for fun, try moving the mouse and then rej 
ing the structure to see the numbers change. We could write to 

-tructure using theS! operator, For more fun than most 
people can stand, push the mouse over to the left side of the 
screen and enter this: 






Then touch the mouse and watch the cursor jump! 

te that the IntuitionBase is considered PRIVATE and 
READONLY by Commodore. Po not write to this structure in 
any of the programs that you del clop, 

]lu IntuitionBase structure contains a I Ibrary structure which 
in turn contains a Node. To see these structures, enter: 

Lbw B '!•,' i Lbi ary 
ibo.se dfit node 

Now let's get back to what we're supposed to be 
doing. The IntuitionBase also contains the address of the 
currently Active Screen. We can fetch from this structure 
member using the S® operator. 



ibase s8 ib__ActiveScr 
P screen structur- 



SCH 






From the screen, we can i. dress of the 1 1 it w mdow. 

We can then fetch the title of the window and print it. The 

word OCOUNT, pronounced "zero count," will 

NUL terminated siring and return the length of the string and 

the address of the first character which are needed by TYPE, 

Enter: 



window value HYWIND my. 



sfl 
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On my system, the first window title printed was: 

Awiga_ i all 

Each window contains a pointer to the next window. 
The last window contains a zero. Thus, we can scan this list in 
a loop until we get a zero window pointer. Let's get the next 
window, Enter: 



d_NextWindow ~> raywind 



rap-wind 



mywind sfl wi__ 
Ocount type 

Sinci- the Amiga is a multi-tasking system, it is possible for 
windows to be opening and closing while we scan the list of 
windows, When scanning any system lists you should first call 
ForbidO and l'ermit(). We did not do this in our interactive 
example because it is impolite to ForbidO other tasks for too 
long a time, 

To see how Find Window uses the above technique to 
get the window names, -., •,■ i] H - following words in the listings: 



fvi.e*-/. 



i-.i 



Find Window filters out windows with blank I 
BACKDROP windows, and its own windows, 

POPUP MENUS 

I wanted the user to be able to place the program's 
main window anywhere on the screen and have the menu pop 
up right over that window, I also wanted to use the left mouse 
button Thus, I could not use Intuition Menus. I decide! to 
implement a popup menu toolbox as a stand-alone toolbox so 
■ could be used with other programs as well. 

To make a menu pop up, you would call 
I ' OPEN with the x,y-position, width, number of items, 
and an optional title, This just opens a BORDERLESS window. 
If the window extends beyond the edges of the screen, it will 

ITiis is determined by looking at the screen 
width and height in (POPUP.OPEN), 

You can then draw the text for the menu items by 
calling POPl rP.DRAW.TEXT with a text string and an item It 
i s assumed at this point that the mouse button is still down, 
because a mouse down triggered the menu to pop up We now 
call POPUPSCANJ which tracks the mouse, highlighting items 
S3 needed until the mouse button is released, POPUPSCAX 
return- tin- item number ( hosen. To remove the popup menu, 
calIPOPUP + CLOSE 

COMPILING FindWIndow 

You can type in the source code for FindWIndow or 
download it from GENIE in the Amiga section. It is item 
number 14135. 

\l orth has the ability to create a small stand-aim u 
application from a compiled application, To compile 
FindWindow and to create a stand-alone application, enter in 
the CI I 







Hie BASIC For Hie Amiga! 



ne BASIC package has stood the test of time. 

Tnree major upgrades in three new releases since 1968... 
Compatibility with all Amiga hardware (500. 1000, 
2000. 2500 and 3000),. Free technical support,, 
Compiled obiect code with incredible execution 
times,.. Features from all modern languages 
and an AREXX port,,, This ts the 
FAST one you've read so 
much about! 





F-BASIC 4.0 System $9935 

Includes Compiler, Lmke r . Integrated 

Ediwr Environment, User's Manual. 4 Sample Programs Disk. 



$159.95 



F-BASIC 4.0 ■+ SLOB System 

As above with Complete Source Level DeBugge- 

feattfe Orty Rem. DELPH NOETIC SYSTEMS INC (605) 348-0791 

P0 Box 7722 Ftap«d City. SD 57709-7722 
Sane Cm** v Mon«y Ow or v*m Pv wo C*» WUh Cnjow Cart v COD 



CH:JForth INCLUDE maki 
To test the program, enter in JForth or the CLJ: 
FindWindow -X 260 -F 3 

You can modify and test the program directly from J Forth 
without cloning it. To make this a permanent part oi vmu 
Workbi iuh, copy FindWindow to your C: directory; then RUN 
it from your startup sequence. 

I hope this program will be useful to you. If you have 
comments or questions, or would like to get the Find Wij 
program and source on a floppy disk, please feel free to contact 
me, 



All source code and executable files for In Search of 

the Lost Window can be found on the 

ACs TECH Disk. 

Pkast- write to 
PhitBm 

c/o AC r s TECH 

P.O. Box 2140 

Fall River, MA 027 22-2 J 40 
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AC Disks 



Source code and executable programs included for all articles pun ted in 

Amazing Computi 



n 



\( \ 4.H. W> and AC V5.10 
Fully l tilidng the 68881 Math Coprocessor 
Part 111: 

finings and TurboJPbtei Function Author Read 
Fredmoic. 

C Notes From thcC Group 5.8 * S. 1 0: Functions 
linked lists, ami a program 
thai will examine -in art line file and rem 

ai have been extracted Author Stephen 
Kt nip 

Time Out!: At < C&sing die Am ai timer 

Vuthoi M.irk i. .«y|iman 

Stock- Portfolio: A program tn organize nil 

track investments, music hhranes. maUin 
etc m ArnigaBASEC Author- G. I. Penn 

Cygcc: \n \Rvw [xogranunuuj tutorial \n- 

■ 

Programming in C on a Floppy System: 
■ develop programs m C 
yte of RAM Author: Paul Miller. 

Koch Flakes I 

1 1 r pn igramnung AuUV >r Pa < 

Audiolllusion: i'xperience an am 

: <m the Amiga in Benchmark 
iuthot Craig Zupke 

Pictures: Hi pictures from past Amazing 
puling i»ues. 
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U \$.11,V5.12«V6.1 

Keyboard Input In Assembly: Fourth in a se- 

itJQQO programming tu 

Author Jell I 

A Shared library for Matrix Manipulation* 
Creating a shared library ran be easy 
Randy Finch 



C Notes From The C Group 
crypto] icn Kemp 

ZoornBo.\: • •■ .hi intuition 

window, and all' ei 10 tOggl 

window's Mjx and Its position luthi i 
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M \<».2* V'6.3 
C Notes 6,2: A reminder pn 

ses Author Stephen Kemp 

More Port* For Your 
article, Aud 

Ultra Sonic Ranging System: BASIC Sonai 

\uthor |i ihn I 

Writing Faster Assembly! Continuing the 
up programs i 

Martin F CJnmbs 

C Notes {.. 3 with functions. Authoi 
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At V6A and Vfj.5 

BUtz Bask 

Wlih MA 1 * 1 '•• integrated BAS itimem. 

Author: Pa iaj 

Creative And Time-Saving Techniques 
raring and line-tuning imag*'" ihrough 
m Pan of the Fractal series Author: 
Paul Castonsj 

Fractal Mod u la 2 Buffered Disk I/O 

iik- inpui and i mi] 
speed Author Mi* 
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Ai Vb.6.V6.7,Vfc8, A *(».'> 

Practicalities Practical uses J i nch"s prevl- 

oust) 'I fatrix library \ 

Selecting and SetUng Gadgets In C: The third 
and Final installment m the 'Crunch: 

rig Authoi Inn I 

t. Notesd.t.: \ new skeletal program io 

Eility programs. Auiboi Kemp 

Fancy Numbers: 1 Ins 

by skipping the translator library Author: 

C Nolcso.7: Adding futtctio 

pattern pn> Stephen Kemp 

Message Logger: s track of 

when pi i run Author Unan /upke 

Foweritasii: cessation 

: i icnt Audi. 
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At 6 .10. 6.1 1.6.12, ".1.7.2. 73 

Funded Over ARcxx Parts 1*2: ARexx have 

■ I cam il .i- ' 
entry-level ARexx 

prograi; Merrill Calll 

Simplified File Decompression I tsing ARexx: 

simple 
ram Author: Rand) I 

Jump Table* in Modula-2: ! 

details.:.* Mi *l 1 1 1. 1 I] . ■ Mil li.il 

Todoe 

DvPu/jh: 1 1 hide program ', ■ 

Author. 
Scoti Palm H 

ZlpTerm: \ 

■ dee on the Ami igThain 

ARcxx Translator: II ARexx 

column I ; s»ng ARexx io translate number bases 
and character cod ill away 

FC talc: Qi templates to 

. Interest and Itnanei 

your credit cuds Vuihot Rick Mana&a 

Recursive Function Calls in ARexx: How to 
'■•.' recursive function calls in ARexx 
Autlior Mernll Callaw 



For more information about the 
AC Disk collection call 

1-800-345-3360 



Getcoiifirm() 

A Dynamic Requester 
Function 



fry Joint Baez 



Usually, in the course of executing some command selected by the 
application user, we encounter conditions in which it becomes necessary to 
prompt the user for a response, I'm referring to requesters such as those which 
prompt for things like: "Exit without saving. Are you sure?" or maybe "Bad 
response entered. Retry." You may also want to present a more extensive 
textual description such as a help display. It is somewhat cumbersome and 
unproductive to build custom requesters for these situations. Intuition does 
provide the AutoRequestQ function. Sometimes, however, you don't need two 
responses and sometimes you may need more. Another drawback of 
AutoRequest() is that you cannot select your response from the keyboard. 
GetConfirm() is a handy little function which adjusts itself dynamically to the 
situation at hand. It provides a very simple way to get a simple response from 
the user or to just make him aware of, and confirm, an event (hence, the name 
GetConfirm). 

Arguments of GetConfirmO 

Table 1 lists and explains the arguments of GetConfirmO* Listing 1 is a 
sample program which shows some variations of GetConfirmO- As you can see 
by running the sample program, GetConfirmO returns a 1, 2, or 3 which repre- 
sents the gadget which was selected. If the arguments are bad, a is returned. 

You should note that the prompt text is a string terminated with two 
nulls, GetConfirmO uses two successive nulls to indicate that the prompt string 
is complete. That is why it is important to insert a '\0' as the last character of 
the prompt string. You may also embed a single 'W value anywhere within the 
text where you want to start a new line, as seen in line 23 of Listing 1. 

The user can select an option by clicking on a gadget with the mouse or 
by pressing the '1 ', '2', '3', or RETURN keys which pond to each possible 

option. RETURN corresponds to option T which is considered the default To 
get a feel for user interaction with GetConfirmO, compile the program as fol- 
lows, using SAS/ Lattice C): 
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kl -rO -ccekmsw -idfO: -odfl); dfO:testconfirm 
Ic2 -V -s -odfO: dfQ:testconf inn 
blink tcstconfirm from LIIJ:co+dfQ:testconftrm.o to 
dfO:testconfirm lib LIB:lc.lib+LIB:amiga.Iib 
SDNDSC 

Listing 2 shows an implementation of the 
cditfunttions used in my prior article, "Keyboard l/( ) from 
Amiga Windows," w hit h uscsGetConftanQi. Use this code as a 
substitute tor the edttfunctions.c code in that article to see a 
more practical implementation of GelConfirm(). 

Listing 3 illustrates the Lmplemental 
GetConfirrnQ, An IntuiText structure is defined for each 
possible text string (lines 40-14). and three gadget structures 
are defined, one for each of the possible gadgets (lines 49-55). 

The gadgets arc first disconnected by insuring that 
the NextGadget field of the Gadget structure — see Amiga 
headers or Intuition reference manual for the Gadget structure 
definition— is null (line 59). We then proceed to see how many 
of the gadget text strings point to a string (lines 66 to 84). 

For each gadget string provided we increment 
num_gadge»s and initialize the appropriate IntuiText structure 



with the text pointer, As we proceed through each gadget, we 
check for the largest text string. The length of the largest text 

lermines the width of all the gadgets (line 92). 

The gadget's width is used in the next step to dynami- 
cally size the gadget's border (lines 96-99). Finally, the location 
of the gadgets is determined (lines 101-114), This is done by 
first checking the type Bag to see if the gadget placement is 
across the bottom of the window or down the right edge I he 
gadgets are then distributed evenly across the width or height 
of the window. 

The window is then opened using the support 
windowO function. This was introduced in a prior article and 
is reproduced here in Listing 4 for completeness. The prompt 
string is then displayed (lines 126-132). and the gadgets are 
drawn into the window (lines 136-137), We then enter the main 
loop (lines 142-154) and wai \DGETUP event or 

a VANILLAKEY. In the case of the VAMLl AKIY we ( na k 
the key pressed to insure that it is one- oifhet alid keys (T, "2\ 
'3', or RETURN). When a valid response Is n • eh ed t we exit 
the loop and return the response. 



I -ilil* fc I. fM k lC'oiiiit*iii() argu infills 



UU.I 111 \ I 




left 

height 

i> i-m, 





tk2 






lit S< Ulfl IO\ 



iter to the Screen structure on which the requester will be displayed. 
The pixel coordinate at which the top of the requestt-i 
The pixel coordinate at which the left edge of the requester will start. 

e width, in pixels, of the requester window. 
The height, in pixels, of the requester window . 



The type of gadget placement- A tie means across the bottom; a FALSE or NULL 

due means down the hy. 

A pointer to the prompt string. 



n ter 1 the tex t string for the first gadg. I ue cannot be n u i 1 . 



A pointer to the text string for the second gadget. This pointer may be null if only one option 
gadget is desired. 

A pointer to the text string for the third gadget. This pointer may be null if only two option 
gadgets are desired. 
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Enhancing GetConfirmO 

There arc a few things we can do to GetConfirmO to 
in.iki' ii I am ii-r. One that comes to mind is the capability to 

ay an Intuition Image as well as the prompt text. You can 
add the capability to display any number of gadgets by 
passing an array of pointers to strings. Of course, this feature 
would require the caller to perform additional preparation 
before calling GetConfirmO, Remember that the original goal 
of GetConfirmO is to pro\ ide .1 simple way to en 
quester, so keep in mind any enhancements that you make. 

A more challenging feature would be to change the 
option gadgets to an Image rather than a Border. This would 
require that you resize the image dynamically based on text 
length, Doing this isn't as difficult as it may sound and would 
make the requester look mora refined. You can probably 
dream up a few things you may want to add to the code. But 
the idea behind a function like GetConfirmO is to let you 

ntrateon your application and use it as needed to prompt 
the application user. Placed into a shared library, it becomes 
particularly attractive to users of simple languages like 
AmigaBasic. in a tutu re artn U- we'll build a "tools" shared 
lihr.irj which will contain GetConfirmO <*s well as a few other 
goodie 

Listing One 



* Tfii • I ••• aout 

lOuld 

• tti* : 






atrncpy Jwor > 



•la* 






■ 









if tram c*u 






Xaaaaga 



*MI v* 






aJiort my*' 

if lage* t ! I *gr • : 

-Age rnt 



Listing Tu<i 



bo ticm |- 



tai 0**3. 



it», nan-cam 



1 7-uia* * cant i rn ^r . . 
r tta, top, Imtt, w*d 



by aouae ot kayboard, 






SCfMal *aca 

t>, taf t , - 

... 

. iMriuge *«; 









• 



4 
italic itruc- 

I0»ll, J. J AMI. i. 

.. 

M 



umti<.i 

IAFTBj . 






■ Man- 



1 Iiat. 
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• eprepriete «edg- 
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coords | ] 



' I It I» 4. 



|i«l /• An? gadOvti to be setup in ■ raw »croi« the window? 
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eadva»heiat 

•lee Low? */ 



* Open th« wnndow. 






- eitt j 



I ■• LI' 

si ib->c:mi..v«ii: 



I uMSTIi 
yadgetel I I m-*Co: 



• trurt Gadget * .■-»XAddr*s. 



CloieWkivSOWlMll 






I islin- I lii-i'i* 
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■ "3 in iMny 

■ 

• ■■■■ »* 

•window mcreen, • 

: ., w« . . , ! . 

■ ■■ ■; •. , . 



>cr«tii 
it imct* 

retui .ndow *iOj- 
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■ (J* I J 
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All source code and executable files for Getconfirm 
can be found on the ACs TECH Disk. 

Phase tm fJ 

i oli it Baez 
c/o AG's TECH 
P.O. Box 2140 
Fail River, MA 02722 
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True BASIC 



DEVELOPING PROFESSIONAL LANGUAGE EXTENSIONS 

FOR TRUE BASIC IN SAS/C 






True BASIC'S recent release of "Student Editions" for three platforms, 
IBM, Mac, and Amiga, at the unbelievably low price of $15, puts the original 
inventors of the BASIC language, Drs. John Kemeny and Thomas Kurtz, once 
again at the forefront of computer science by making modern, structured pro- 
gramming available to the largest possible number of people. Combine that 
with their recent "UNIX Editions," and True BASIC stands a good chance of 
becoming the standard dialect on all computers. In fact, many people are 
already referring to it as such. 



To the intermediate or advanced lei el programmer 
on a particular platform, like the Amiga. I mis a new 

opportunity: to design competitive language extensions or 
LIBRARIES for a variety of high level tasks, and to publish 
i hem as either public domain, shareware, or commercial 
product, Such utilities can be designed either in True BASIC 
itself , C r assembly, or in an) hybi ination If you know 

enough programming to write reasonable utilities, this, may be 
just the right kind oi activity for you. Mail] ol the I omplex and 
just plain tedious system requirements of stand-alone applica- 
tions (like screen and window definitions to name only two] 
already solved for you by True BASIC. All your routine 
may need to do is accept a few arguments, process them in 
ways that would otherwise be too difficult or time consuming. 
and then either perform some action or return a final vail 
True BASIC. By writing such routines you will profit by 
putting to good use whalevt-i programming skills you have 
developed SO tar on the Amiga. It may be just what you need 
if you have been suffering from a long technical slump. At the 
same time, by publishing your work you will be helping many 



others remain excited about the Amiga by making it easier for 
them to program their machines in BASIC. 

This article focuses on the steps required to del 
ReadJFFJmage routine, which is written partially in C and 
partially in True BASIC— a so-called hybrid design The result 
is a L1BUAKY file that can be used programmer, 

advanced or beginner, to read IFF pictures and brush* 
within their own programs, including MAM and Ev 
Hall Brihv and at impressive speeds. 



RUHCiROlM) 

I rue BASIC is a well-establ ill -sup ported, 

■I ompliant, platform-independent dialect of BASIC that 
provides all the high level features around which the language 
was first developed, features that are sorely lacking in -.,.. 
others. True BASIC is Kemeny & Kurtz's answer to what 
BASIC should be liki ana nrucrocomputer. It has 
successful thai it is presently available for more platforms than 
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parameter 
inC 



Argument 
array 



arg 




Values in 
True BASIC 



> input argument #1 



> input argument #2 



output value 
returned to 
>- True BASIC by 
C routine 



Figure 1 



: I In- level of the ROM Kernel 
Manual. Finally, and as Ihis article will 
demonstrate, [rue BASIC allows you to 
m n language extensions or 
I ink WiWS, thiiH providing persomatized, 
high level support The routines within 
such LIBRARIES can be accessed in two 

-. either from the disk tiles where they 
are Stored, or by merging them into 
1 ible mentor) along with the 
language itself, a concept called "loading 
your wot kspa cc ' ' I oad i ng LI BRA I 
into your workspace makes their routines 
available to your programs instant' 1 
they were a part of the actual Langi 
and without thi Lie any Ll- 

BR Wi\ instructions within your pro- 
grams. 



any other single dialect. In fact, it is now being embraced by 
the UNIX community, as shown by the recent article in the 
May/June 1992 issue of BASIC-PRO Magazine (available on 
most newsstands) showing True BASIC being used to design 
animated CAD applications on the Silicon-Graphics, UNIX 
w « ii kstalion. The example code from that article can be run 
essentially unmodified on any IBM, Mac, or Amiga 



ixit-r pit it now* 

Many Amiga users, upon hearing the term plai I 
independence, immediately put down True BASIC, thinking 
that it will reduce their machine to the level of the most ill- 
equipped IBM clone. That is simp; f rue BASIC has 



You can design a I IBRARY to 
perform a partk utar task on one platform, 

ement, 

in which case \ our u ork i .1 1 

essentially unmodified to any other plattorm supported by 

1 i ASIC. But even platform-specific programs, like the one 
of this article, can be ported with surprising ■ 

similar LIBRARY 1 an be designed tor both the IBM and Mac to 

read IFF images wi them as well. Indeed, It is these kinds of 

itples thai demonstrate, once and for all, that with toda) 's 
complex operating systems, H Is I me BASIC that is the most 

r n -i - 1 ndepend en t I . lH 



HVBRlIi »1M(.\S 

Reading IFF pictures requires a reasonable amount of 
specially when the graphic data in the 

Bt H >Y chunk of the IFF file i- n mat, as is the 



True BASIC has many powerful and unique features, especially in the 
area of graphic s, that will allow you to get more out of your Amiga. 



many powerful and unique features, especially in the area of 
graphics, that will allow you to get more out of your Amiga. 
One example is structured drawing, which allows you to easily 
design complex images in a hierarchical fashion, exact! \ 
recommended by modern programming theory. You will not 
find that feature in any other dialect of BASIC for the Amiga. 
Indeed, it is not a part of any other language. In addition, True 
BASIC provide 1 1 the entire Amiga operating system. Jt 

does this in three ways. First, like most programming environ 
ments, it allows you to invoke any routine in any of the 
Amiga's run-time libraries from within your BASIC programs 
Second, it provides some high level libraries, like Font Lib* in 
the AmigiiTuols drawer, which allow you to enjo\ certain 
custom features of the Amiga without having to program it 



case with pictures and brushes saved by most painl programs. 
High level languages like BASIC simply cannot perform all the 

Lions required to decode them fast enough. In conti 
can complete the job m -,...•, uul -. Hut C also has some dtsadA an- 
tages. Designing stand-alone applications in C can be very 
le, in my n gazine 

called "Programming thi fa's GUI in C," it took me three 

articles just to open a graphic screen, something that can be 

done in True BASK with .1 single instruction. Win 1 

complicated ' Because most implementations are published .is 
sional development packages, where everything that 
lo requires diret 1 Interax Hon with your computer's 

em, as outlined in the R( 1 M Kernel Manual. Very 
tittle, if any, high level support is provided, Asa result, you 
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must desigi sped of your program from the ground 

gramming in such environments may be outside the 
patience and time constraints ge hohbvists. Indeed, in 

today's busy world it may be impractical for many profession 
a Is as well, 

- r to this performance/complexity dilemma 
is to desjgn jrouc programs as hybrid. packages— partly inC, 
where program execution is fast„ and partly in BASIC, Where 
many standard S) stem operations are fully supported. You 
won't be able to completely divorce poursell from having to 
know something about the Amiga's operating system. For 
example, m order to make the example ol this article execute at 
the fastest possible speed, I had to design it to write graphic 
data directly to screen memory, something that required an 
understanding of the Amiga's internal workings I lowever, by 
making it a hybrid design, the amount ol such direct interac- 
tion was greatly reduced. The Read IFFJmage routine of this 
article demonstrates the well-balanced use of both low and 
high level design tools. 

uld point out that the new 2.04 operating 53 sten 
has a special library- called iff parse, to help programmers 

: and write applications. However, one short 
peek into I R( )\\ Kernel Manual should convince you 

that, in order to us*- it, you need to be an adl Bin ed program- 
mer In contrast, the source code of the Read JFFJmageO 
routine on this magazine's disk clearly demonstrates that the 
parsing of an I M I : be is much more easily coded in BASK 
without using the ifjparse, library, This is especially true if you 
want to add to your design a few higher level features, like 
automatic screen resolution switching and error checking, 



PRODI 1 IDVG I ICV I IE ASM SI BKOI TIMS I\ 

S IS/C 

To produi BASIC SUBROUTINE or FUNC- 

1 1( HN using sas/c, you con urC routine using -bO for 

absolute addressing with the first pass compiler program LCI, 
and -v to suppress stock checking with the second pass 



program I I INK your routine slightly differently. 

Specifically, you pass the routine's object code through the 
BLink program, but with the exception thai you do not include 
the usual startup code LIB;c,o the result is an object file that 
cannot be executed on its own, but that, with the help of a True 
BASIC program called FinalTouch, can be converted into a 
form that is executable from any True BASK program. 



%1Cf.il hi: vr iv%ssim; 

The most important aspect of writin ROU- 

TINES for 1 rue BASIC is the communication between the two 
languages. True BASIC Hues to the ( routine in the 

same way as it does to any SUBROUTINE or FUNCTION, 
through an argument list. The C routine then accesses them 
through a parameter 1 ailed arg, which is a handle (pointer to a 
pointer) to an array OJ pointers that represent the arguments 
that were passed by True BASIC ll the way a 

parameter called argv is used to read command line arguments 
in AmigaDOS A second parameter of the C routine, called uv, 
is a p< 1 structure whose members contain some 

important system addresses, which can be convenientl v 
Kwed by your C routine. Below is the generic, ANSI 
prototype definition fora C routine thai is intended foi u 
a SUBROUTINE or FUNCTION from True BASIC. 

• 

True BASK proi ides a header file (in the Assembly drawer of 
the line BASIC disk] thai contains the structure template for 
the above TBUserVeclor, as well as structure templates for two 
types of possible arguments, short integers and nhus., 

your C code must contain the following inclusion 

Lude "T: :Asseml 

Vou can design your C routine 10 be either a SUBROl HNFor 

.1 f'L'NCTION. In both cases, values are accessed on the C side 



parameter 
inC 



Argument 
array 



Argument 
structure 



arg 



arg #1 



struct TBInt 



exponent 



integer 



Figure 2 
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Da ra mete 
inC 




Array of 

pointers 








Argument 
structure 




org 


--> 


arg#l 


--> 


TBString 
pointer 


---> 


struct TBString 
















■ 


length 


textO 








Figure 3 







by using add n i Otenl array. In the event 

that the routine is to be .1 I I fN( I H. )N, in *» liu ri case it will 
return a value to Trm BASK , an extra element is provided at 
the end of array for thai pur; SHOWS the general 

concept. 

IYI K.l It \KC-t >ltlMS 

Integer arguments are accessed through a spec us 1 1 
stt lh tun called TBIru, whose template is defined in the header 
file TB.h. For each element on the argument array that corre- 

I a numeric argument, there will exist in memory a 
TBIn« stTVK hire thai was generated by True BASIC at the time 
the C routine was invoked, I lere is the template definition of 
rs in TB.h. 



uct TBInL 



■ 
short 



• 






Exponent is a flag that identities the structure's data as being 
either ty pi I or type floating point 1 ■ 1 means integer). 

The integer member contains the numeric value itsell 

■ re passed as 16-bit values in 2's compl 
form, which is equivalent toSAS/C s short integer. Figure #2 
shows a SUBROUTINE having one integer argument. Note 
thai the passing ol king integers and floating point numlvi^ is 
done using a slightly different method, which is fully ex- 
plained in a related doc file on the True BASIC disk 

VI KIM. Utf.t WE VI S 

Strinj cessedlhn died 

I i : - 1 1 ing, whose template is defined in the header file TB.h. For 
each element on the argument array that corresponds to a 
strinj,: argument, there exists in memory .1 I BString structure 
that was generated by True BASIC at the time the routine was 
invoked. Here is the template definition of that strut lure ,1- il 
appears in TB.h. 



struct TBSi 



The template shows a character array of only one elei 
However, the structures that True BASIC generates for your 
routines will have arrays of whatever lengths are required to 
1 heir arguments, up to a length of one megabyte. Figure 
hows a SUBROUTINE having a single string argument 
There is a difference here from the previous integer 
example, I he address on the argument array points not 
directly to a TBString structure, but to a pointer to one. This 
will affect how the data from a string argument is accessed, as 
\im wilt soon '- 

(.1 M II U C ROUTINE 

With everything that has been said so far, we are led 
to the following generic form, or model, of a C routine that is 
intended for use as either a SUBROUTINE or FUNCTION 
from True BASIC. 

• "True BASIC:.' ra,h" 



Jsr_routin<: 



void usr_rou 



'arg, struct TBUser Vector 



»arg, struct TBUserVector 



I 



code to read arguments 



code to r value if a FUNCTION 
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\< Ossim; tiik aim; i >iim s 

foaa ess argument valuta from within the C routine, 
you must declare pointer variables of the correct types and 
assign to them the various addre ied hy True BASIC 

on the argument array— addresses that represent the argument 
structures that were created when the routine was invoked. 
Here is how the addresses or lour argument structures, two 
its and two strings, can be read and assigned; 






*arg. TBUserVector 



from True BASK which is AS, and arg,4 to point to the last, B$. 
Figure #5 shows the result. 

Pointing to the argument struct ly half the 

job, To obtain actual values vou must read the contents of 
those Structures. Here is how that is done for the above 
example: 



exponent . 



' 









q "arg3, ■ 



' 



arg2 = {struct TBInf. ' ' 






arg4 



. 



*arg; 



The above code represents a routine that could be used as a 
i &ROUTTNE from True 
B \S1C in the following 
way: 



int x» y, 


alen, blen; 


cba: 




if tai 


expo: • 






>- 


>integer; 


. 








ngth; 


b 




= arg4->length,* 



. 



:elX, 
BS > 



The first address ot 
argument array is read by 
de-referencing its and 
gning the address 
obtained to pointei 
The post decren 
operator then moves are to 
the next element position in 
the argument array. The 
result is that argl points to 
the I Bint structure i 
spending to the first 
argument passed from [ rue 
BASIC, which is X. Sum 
larly, arg2 points to the 
second, Y. Figure #4 shows 
the result. 

For strings I must 
ie re nee arg twice, 
because their addres 
the argument array 
represent not the TBString 
structures themselves, but 
pointers to them. The above 
in st i actions cause arg3 to 
point to the I BS! 
structure corresponding to 
the third argument p 





argument 
pointer 




Argument 
structure 






argl 




struct TBInt for X 










exponent 


integer 












arg2 


> 


struct TBInt for Y 










Figure 4 


exponent 


integer 
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tt is prudent to verify that the exponent member of inh'gi-r 
■ :r Aliments is -1. Otherwise, the integer member contain 
that is in Boating point format, and must be handled differ 
ently. 

\>nip \ system poiyh ks 

To use the Amiga's run-time libraries, a program 
rec|u t r i. a » I hei r respective system poin ters. We cou Id 

obtain these oursel ■ plicitly opening each library, but 

it's easier to use those already opened by True BASIC. Thi- uv 
parameter of the C routine is a pointer to a TBUserVector 
structure, which is defined in the TB.h file, and which contains 
tin/ addresses Ol tin; run-time libraries being used by 1 rue 
BASK As you can see below, you also get the address of the 



window structure that True BASIC is using foi your program's 
output. 

struct TBUserVector 

( 

struct Window •window; /* pointer to our window •/ 
long DOSBase; * DOS library point* 

long Gf xBase; * i. iphics library pointe: ' 
long SysBase; * :jrary pc 

long Intuit ionBase: rary po,-- 

' 





argument 
pointer 




Argument 
structure 






arg3 




struct TBString for A$ 










length 


text ( ) 












arg4 


>. 


struct TBString for B$ 










Fiaure 5 
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text ( ) 
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I Hi: IftlvSIG* PLAN rOK Itoad II I Ima^ 
To save deveJopnv ind allow for 1 1 

maintenance I hat e designed all set tions that do noi signifi- 
cantly ecution time in BASIC, and the sections that 
require cither heavy pressing, or th.n -torn struc- 

in C The BASIC section, which is invoked by .1 CALL to 

d D 1 Image, opens a channel to the file, parses it, per- 
forms error checking, possibly swih hes the graphic resolution, 

finally invokes the C routm, _DisplayBod} 

1 it a string containing the graphic data read from the 
BODY chunk of the IFF file, as well .is some other related 
information. Thus, Read_IFF_lmage is a driver routine fot 

C DisplayBody. The triple under-bar in the name is mj 

n ay of identifying the nature of this routine and its related 
fi les. Of course , you n ha lev er nota tion you like, 

THK € PART 

Fhe< 1 tody.C source code on disk is 5 

commented thai you will probably find it instructional. The 
first order of business is to declare pointers to the argument 
structures p.isned from True BASK . I"he firs! 0! these is the 



is less than that used to create the original i 1 d if the 

programmer has suppressed my automatic screen switching 
feature As a final protection, the pointer thai reads the graphic 
data, "gdp (graphic data pointer), is constantly checked to 
make sure that it does nut gel accidentally incremented beyond 
the end of the graphic string that was passed from True BASIC. 
The routine handles both uncompressed data and data that 
was com pressed using the standard ByteRunl technique 
described in Commodore's IFF specification. 

THK BASIC PART 

Although everything performed by ReadJFFJmage 
in BASIC could theoretically be accomplished Easter if it was 

J m C . the overall speed of the utility would not be 
improved enough to make the effort of doing 50 worthwhile. 
In fact, you might not even notice the different e in overall 
speed. In addition, and perhaps more importantly, by design- 
ing most of the program in BASIC, my work remains open to 
the widest number of users. In the event that you don't like the 
way it works, you can easily moditv it, even if you are not an 
advanced pro? But don't think for one minute that, 



Although everything performed by Read_IFF_Image in BASIC 

eoidd theoretically be accomplished faster if it was re-designed 

in C, the overall speed of the utility would not be improved 

enough to make the effort of doing so worthwhile. 



graphic string I he ot Iters represent j variety of related 
information, like image width, height, depth, position, etc., all 
of which must be known in order to properly decode and 
display the image. The program reads each argument structure 
address, its argument values, and the Amiga system pointers 
using t in. techniques I have described above. 

To achieve maximum execution speed, I have 
ned this routine to write the graphic data directly to 
screen memory. As J mentioned earlier, to do that I had to 
understand how the Amiga handled screen memory, and to do 
lh.it, I had to study the ROM Kernel Manual. Mv solution 
defines an array of pointer- hl'laned, each clement of which 

1o an individual bitpianc of the current screen. The 
routine learns about such things as the current screen width, 
I and depth from the op. tern's Screen and 

lap structures, which are lot ated via the Window address 
handed over trom I'r ue B tSK ! ni lowing that, my routine 
enters a data interpretation section where the actual graphic 
data is decoded and written to screen memory. An inter, 
feature ot my design is thai it allows you fo position the image 
on the screen from within True BASIC. Position information is 
used in the calculate reen addi\ wre writing the 

graphic data to the screen The routine also I lips portions of 
the image diat fall off the right and bottom edges of the screen, 
pre* enting it from wrap, und to the left edge, or worse, 

writing post the limit ol screen memory and corrupting the 
operating 53 stem In addition, tht irds extra bit 

plane S graphic data if the current graphic mode 



because the majority ol this utility was programmed in BASIC, 
it is inherent]) a bad design, I >n the contrary, the file contain- 
ing Read Jl i Image consists of a collection of indepe 
fundamental program units, likeOpen_Communication, 
Read.FOF BMH1 Read_CM~AI\ Read JZAMG, etc., 

all of which get invoked in a hierarchical Fashion, exactly .is 

led by the most modern, structured pr ng theory. 

In addition, .ill f me BASIC routines that are hierarchically 
subservient to KeadJFF I e made PRJVA IT. I 'hat is, 

they are made inaccessible from outside the utility. L - 
struetures. called MODULES in True BASIt certain 

program units within a utility from being used by von in ways 
that were not intended f he\ .liso protect the routines of your 
own programs from conflicting with those within lh> 

ince you go e one a same name. Lastly, MODULI'S allow 
\,i r uibles to be shared implicitly between a certain m 
program units, Vk Ink- ,ii the same time keeping them hidden 
from the remainder of the project. These are advanced features 
that most : ler possible only in G or Pascal. They 

are not on!) available in True BASIC they are cm i> 
implement 

When you inspect the I rue BASK code, pay attention 
to the use ot exception handling, which produces smart error 

lor a wide variety ol possible < conditions. It is not 
only a good idea to provide such features in your dc- 
eas) to do. I also recommend th.it the programmer using this 
utility incorporate exception handling within his/her own 
programs, as shown in the example code near the end of this 
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ankle. This will protet i • Nine m ihe event thai an 

unexpected interruption occurs while it is in either 1 1 AM oj 
Extra*tfalf-Bribi Vou see, although my routine supports these 
special graphic modes, I rue BASK itsell officially does i 
and it may not recover properly it a program terminates 

i cfedty u lull- it is in one of them. It is exact!) for 
situations Like these thai True BASIC provided its exception 
handling feature 

data is read from each chunk of the IF] 
tilt 1 using True BASIC's UnPackBQ routine VI huh can read 

data in a hit wise fashion at any location in a string of 
any length. I take specific advantage of this bitwise feature in 
routines \sk 1 1, HAMS and AskJMHB!-.. Programmers 
wanting to do the same thing in C have to design their own 
rouli hii masking. Lastly, I am particularly proud of 

the section thai automatically switches die graphic resolution, 
should the progran it to use thai feature, dial section 

would be very difficult and tedious to design in C In BASIC it 
was quiti 

c 'inii-i 1 ix. nit: c coiik 

Ihe following LMKFILE which is used by theSAS/C 
1 mk program to compile your source code demonstrates 
exactly how n is ^ione. 



gUAD: 

TO S 
LIB: 






, I BRARY 



S ( PRO 

UflGSI $ (PROGRAM) 

■OGRAM) .0 QUA 









Note the options used w hei ng the C sou n 1 

through the compiler. The -hi' 1 (32-Oi! addressing) option must 
be used with LCI, and -v (no 1 eking] w ilh I I 

Without 1 1 1 ese options youi routine will nol • ■-thlefrom 

True BASIC, The rest ol tin- stufl is re., ommended, but not 
necessary. Now look at how the linker is used. The usual 
startup code is not Spei ified To do so here would 
produce a self standing, executable program, and we don't 
want to do that, Instead, we want an object module that will 
I hv True BASIC But first it needs to be 

(OWKRIIM, THE * KOI TIM 

The program calk 1 uch', which you will find 

in ihe Assembly drawer of your True BASIC disk, is used to 
convert the object code that was produced by SAS/C using the 
above 1 Y1KFILE into a pi unit that can be invoked from 

am True BASIC pn \ hen you execute the l inalTouch' 

am it asks you for two entries, the routine's definition, 
and the name oi the file where it is located, To convert this 
example 1 entered the following: 

■ 



jned theC DispLaj Bod 1 as e I L M( I ION to 

take one sti ing argument, followed by seven integer argu- 
ments, and to return an integer that reports successor failure. 
Thus., to invoke II from fun. BASIC requires 



LET Error 



des: 






But, of course, the people who use this utility within their own 
BASIC progra ms don' t have to specify all thesn nts. 

Nut is done for them autc f by the Read III I 

routine. 

( <Miiti\i>4. ivro % si'ngit; iivbiuii 

At this point ihe two parts of the utility, BASK and C, 
are in separate files, A more convenient approach would be to 
bind both parts together into a single LIBRARY file. This can 
be done using True Makelab' utility, which you will 

find on your True BASIC disk Figure 16 shows a hierarchical 
d iagra m rep resen t i 1 ..Mill mage and 

C DisplayBody routifM s Mote, however, lhal the complete 

utility encompasses the use t several PRIVATE True BASIC 
routines, as well as -»ix oilier C routines, which for bre 
sake I have not mentioned For that reason a complete hk 
chical diagram representing the entire utility would be more 

The 1 IFF*, can be used as .1 I [BRARY to 

ively add to the True BASIC language the ability to read 
II F Hies, including those in HAM and Extra-Half-Brite. N'ote 
that this utility requires ihe latest version of Tn The 

reason for this is that I have used some of the language's 1 
; res, like MODL I I S, which were nol a part of the older 
ion. 

USING 1 111: 1 Till 11 

To actually read an image and displa) it 01 
conds, complete with True BASIC'S except I ! sng 

feature, you could use the following 

•AM Shov; 

IFF** 
WHEN ON TN ! 



LET ModeS = "IFF* 
-IFF" 

KolorS. X. 
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TheModeS and irguments are used lo control whether 

you want the routine to automatically switch the current 

< lor definitions to those th.it were 



in effa i when the anginal IFF image was created. Making the 
ModeS variable equal "III " act nates automatic mode switch 

whereas leaving ModeS = "" (a NULL string) deaeh 
it. I he KolorS argument works the --.mir u ,tj 1 he X and Y 
variables are u&i 4 the image 

on the screen Remember that True BASIC defaults to Normal- 
ized Dei : nates (a 1x1 grid with the reference al 
bottom left comer), My above ol \ alues places the 

.-...■ al the top left corner of the screen, N 
the 54 reen these numbers w ill have to change. An error is 
produced if you use coordinates that place. the top left coo 
of the image off the screen 



PROGRAM Look.Picture 
CALL ReadJFFJmage ( ) 



file = Look Picture JRU 



File = IFF' 



* 



SUB ReadJFFJmage 



Let Error = C_DisplayBody 



FUNCTION C_DisplayBody 



— j 



Figure 6 
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The Computer 

Service and Repair Video 
AMIGA Edition 

This video represents six years of first hand 
experience repairing the Amiga Computer . 

Covering everything from basic theory of 
operation to our special tricks and lips sec- 
lion this video is sure to save you many 
hours of unproductive diagnostic time . For 
both the user who would like to understand 
inner workings of this amazing computer to 

die experienced technician this video can 
save you time and money . 

5tnd your rtav k or money order Tor 
$39.95 + $5.00 Shipping & htrxlllnt 1° 

J & C Repair 
PO Box 70 

Rockton PA 15856 



Allow 4-* wrtki far Mirer 



C«ci» 1DI on R*od*f Swvtc. cord 



I have used True BASIC'S EXCEPTION featufi 

m in the event that the file "Gorilla. If I 
HAM or EH 13 image, as outlined in the related doc file on the 
True BASIC disk. Should a sj stem error occur white in i me of 
modes, the exception handler, the part between the USE 
and END WHEN instructions, will gel executed Thus, the 
MODE_OFF SUBROUTINE will always get invoked. The 
entire section between the V\ { \v\ [ON and USE 

instructions is protected , inc ludi n k( I UTTN ES or 

I L N( i IONS thai get invoked by thai set Hon, 

One last word about 1 1 thisutilfr) It is 

advised thai, once you have imported an irna^e into True 
BASIC P you convert It to Tru e 1 1 \ S t< i , which is 

called BOX KEEP. Doing SO will not only allow True BASIC to 
read it from disk more quickly, but also to read it without 
displaying it immediately Thus, a program that uses, say, five 
images, can lo.nl them .ill during the Initialization phase 
operation, without the user even know • M it, and keep 

them in memory <]s strings until they art- required True 
BASIC s BOX SHOW instruction can then be used to render 
them to screen, which, incidentally, executes so fast it can be 
used to display framed animations. 

FILES G!> THE >1\d\/IM IIISK 

All files representing the design of this True BASIC 
language extension are on the magazine disk. Ill I HI 

contains the I rue BASK source for the library. TheC #? 

files contain the C routines that are used by the various 
routines within tJT.TRL". The files with an asterisk have been 
compiled ami i muerted using the Final I mn h program. Mote 
that within the IFF TRU file there exist several LIBRARY 
instructions needed to access the various C routines, But for 
this to work all these files must exist in your current working 
directory. In contrast, the IFF* compiled LIBRARY contai 
compiled i erskm ol II FTRU, as well as all the C routines, all 
in one convenient file, This was done using the MakeLib 



program, as I described above. It is intended thai you place the 
III" LIBRARY file in your Amiga [bob drawer i essit hv 

h riling the following instruction at the top of your progi , 

•■ 

Note that ■ iign has been accepted bv the 

company True BASIC, Inc., for inclusion into thetr I, 
"Student Edition" product for the Amiga, which you need to 
purchase in order to run it Til will get the latest \ erskui 

ot II I ' u hem you purchase True BASK 

So whj you ask Is the source code for what seems to 

official part of ,i langlia HI being openly dislrib- 

uted on a magazine disk? Because both I and True BASIC, Inc., 
want It to be more than just a utility to use. We want it to be 
one to learn from as well Hoj • •■ i-hat you see here will 

convince you of the power of True BASIC on the Amiga and 
inspire you to try .1 few sntuLu designs yourself. But even if 
you never do that, even if you simply use the utility to enhance 
your own Inn II V-.K programs, it is still important thai vou 

the source code- There is nothing more frustrating than 
trying to use a programming utility that does everything you 
want except tor one minor detail, and having no way of doing 
anything about it. Having the source code 
to make it work the way you want it to. Feel free to impi 
the Read _IFF_I mage routine to meet your own needs. If you 
make significant improvements, you might consider pub 
ing your work so we can all profit. 







The new "Student Edition"' of True BASIC, version 2.0 
for the Amiga., is ai ailable 



True BASIC, Inc. 

12 Commerce Ave 

West Lebanon, NH 03764-9758 

(800) 872-2742 

(603)298-8517 

FAX: (603) 298-7015 



-\ 



lMoiisi" write to: 

Paul ( asf oiigua> 

c/o AC"'* TECH 

P.O. Boy 21 10 

frail River. HI A 02722-21 40 
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No Mousing 
Around 



ff Dickson 



The Intuition pointer (Mouse) stays wherever you 
inetimes can db | wrtiofl of the screen 

you 're looking at. While the at tual size of it is small, the 
pointer is rendered at an angle which means, for example, thai 
one Off two characters of text can be hidden, This could be 
annoying when editing text files and perhaps more so during 
programming, because in some languages (e.g.. Assembly), 
one of two characters can make a difference. Often, your only 
i ' '. ouise under these circumstances is to physically move the 
mouse. 

The Intuition pointer is implemented as a sprite, but, 
because sprite is used, it cannot be covered up, Programs that 
open windows can change the appearance of the pointer, 
including hiding it, hut few do. The only other option open to 
US is lo move the pointer under softwa re control 

The Input Device is used to accomplish this feat. An 
input handler is inserted ahead of Intuition into the Input 
Device "food chain." Of the many varied types of input events 
that can come our way, the Otlh two of interest are 
ECl ASS.TIMER and IECLASS_RAWMOUSa Timer events 
are used to maintain an inten a] timer, Mouse input events are 
used .is a cue to either restore the pointer's original positio 
to sample its current X/Y coordinates and restart the timer. 
Movement of the pointer is handled by the 
lECLASS.POlNTERPOS input event. This input event i> 
special in that Intuition ire.-its the supplied pointer's coordi- 
nates therein to be relative to the origin of the Intuition view 
(upper lefthand corner of the screen). 

In .ictual operation, the inten al tinier is decremented 
every time an IECLASSJTIMER input event is seen. If an 

ASS RAVVMOUSE input event occurs before the timer 
has expired, the pointer's current X/Y coordinates are sampled 
and the timer is restarted. If, however, the timer does expire, 
then the pointer is moved using an !ECLASS_POlNTERPOS 
input event to the upper-left corner of the screen, Anytime 
afterwards, if the mouse is physically disturbed in some 

it i. r . moved, button | .mother 

IECl.ASS_POINTERPOS input event is inserted, but this time 
contains the pointer s last ampled coordinates so that Intu- 
ition will redisplay the pointer back where it originally rested 
In both cases, the fECLASS.POINTERPOS input ■ , enl 

edes the input event that caused the action taken- For tin 
latter, this could be especially important if, for instance, the 
pointer hovered above a gadget, was moved mil of the way," 
and then the user depressed the select button (left). At this 



point, the entire procedure starts m 

The KLASSJtAWMOUSE input event includes an 
X/Y position field, but the coordinates of the pointer therein 
are relative to its previous position. For this reason, tin 
pointer's true X/Y coordinates are obtained directly from the 
IntuitionBase MouseX and MouseY fields, Because these two 
fields are direct I hie, meaning that no pointers that 

could change need be dereferenced, IntuitionBase is not 
locked. To play it sale though, both fields are sampled at the 
same time This prevents the possibility oJ an inaccurate 
reading. 

The program is written in C and Assembler, C is used 
to initially install the input handler and tear it down when a 
control-C is sent to the process from which it was begun. The 
input handler, written in Assembler, performs all the grunt 
work necessary to move the mouse when it remains inactive 
for the preset I re it when the mouse is disturbed 

insomemannt'i Input handlers have the option of being 
passed a data area when they are invoked by the Input Device 
task, but for purpo- ty only the value of regisl 

A4 is passed. The input handler always presets register A4 to 
this value — meaning that variables declared in the C program 
are accessible by the input handler. This operation is sv n 
mous with the GetA4Q function provided by most compilers. 

The program has been tested under both OS 1.3 and 
2.04. It is recommended th.it a copy of the 1.3 ROM Kernel 
Manual be close at hand, because the intricacies of adding 
Input Device handlers, opening devices, etc., are not elabo- 

upon here. Also, it will help you to better understand the 
program. Enjoy! 

Building the Program 

The MANX C compiler package was used to assemble 
and compale the program. Below are the steps involved, 

nput Handler . asm 

cc -o NoMousingAround.o NoMousingAround.c 

In -o NoMousing; . MousingAround.o 

Input Handler. o -1c 

The program accepts a single numeric argument. This 
gives you more control over how long the mouse must remain 
idle before the program moves it. Typically, every unit 
represents t tenth of a second, but can wiry depending on 
system load, If a number isn't specified, then this value 
defaults to 50, yielding an approximate delay of five seconds. 
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Listing One: Input Device Handler 









i 



Hai ■■-< rori Mi i 



j Symbol ■ known ta l . 

v'Mt 



: Symbol* 



XREF 
XftEK 

XREF 
XKEF 
XREF 
XREF 



_downcntr 
.state 

i.tialem 
.103 



- Structure 
•■■ 

C erefl t 

J£CtASS_PAWHOUSE BOO 3 

was bqu 4 

2ECLft£S_TIHER EQU G 



'■' . . •: 




House* 


■ 


; Sims 






Iftove.i o*.dQ 




rta 


: Pre 


■ouae ewn 


i rani i 





rts 



'ho mouse IB phya:* 
i restart the 

ately restore 

to where it origii-„j 






had nor been acved by 

pointer's 



1 onto 



M 



move. i 



; set up r* 

■ 



: we " : • i u ._-. i 

inot e 



rap; . 









Inpu' 



y lover 









' Laar 



out of 






bne.a 

• event, di lawn counter 

S ■*! ri»fft 

ve the 9 
bne.B Next Event j don't 



mavo.l _d 


iown count 












,- decreeerr 




; update new value 


bne.a Nextr 






: read} 


















nstead a tn 
: InL'. 



. 












cJickB.dO 



bra.L 






<nge state 
; rest i 
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movea. 
roovo, 

Swap dQ 

move.] d0*_ 

move. k*,dO 






J Hol 





: i - - r int in 






-.'■•- - 


move 








bne.s DincemEvent 




j- all done 


La iwbj 


r 






went chain 






mover. I lap). 



end 



Listing Two: MakeFile 



-lc 






Listing Three: No MousingA round. c 



Version ] .,:, 

I V I '- 

I i 

I I I 



Karkctri 









lude 



< exec / t /pes . h > 

n s.h> 



^iieof 

■ 









ilea u*ed by 



-■a */ 
long *r«t 






' 



Lib ■ (lortgtopei 

TRlAllocM ■ 

riKTPTR)AllocMaa>l ti 

rt<0L, 01. in 1 

• 1 









1MXI 

Prea«-' 

ia«rb->jn_Da.t.> 

-'■DHAND1 
ioerb- >j _'!-•_. 

i • '. •■ 






RUJC1 s 



■ atri 
rXHANDLER; 



CetMagtrp) 






- 
Closet. . 







Please write to: 

Jeff Dickson 

c/o AG's TECH 

P.O. Box 2140 

Fall River, MA 02722-2140 
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by Paul Gittings 



WARNING: The procedure oullth, \ more than 

likelu ivut the ivarrantu oit your com \ible to 

your computer and peripheral carried 

out correctly. If you are unsure about is area 

arrange for a qualified techtiichian to install the tape drive for you 

You can lose files and data on your hard disk due to 
mistakes, power surges, or programs which run amok, We all 
know that backing up our hard disks is an important step in 
preventing such losses, but how many of us perform these 
backups on a regular basis if at all? The idea of sitting in front 
lit thi- 1 nrnputer for about an hour, or ! tg it floppy 

disks is enough to put most of us off; however, we soon regret 
this once we have a problem with the hard disk. 

One solution is to backup the hard disk onto a 
Tapes can hold lots of data and they are a plug and play 
operation; you stick the tape in, start the backup program and 
then there is nothing for you lo do until the backup finishes I 
did a quick survey of the market dhere in Australia; I looked at 
the advertisments in two Australian Amiga magazines. The 
Australian Commodore and Amiga Reivtivano 
Amiga User Magazine, I was not able to find one company in 
Australia which was selling a tape backup solution for the 
Amiga; however, I think this has now changed and GVT is 
now selling such a system in Australia. Unable to find an 
Amiga-specific solution I turned to the- IBM-PC and I NIX 
markets in the hope of coming up with a "roll your own" 
solution 



In the IBM-PC world there arc tape drives which 
Conned to the (loppy disk drive controller. These tape drives 
are relatively inexpensive and the tapes tiny use can hold in 
the range 40MB-80MB [ hey would be a nice solution but no 
company has developed an interface to connect these drives to 
the Amiga. 

Next I turned to the t MX systems The in-things in 
the UNIX backup world are "Exerbyte" (which uses Vidi 
tapes) and "DAT" ( which uses Digital Audio Tapes) backup 
systems. Both of tin s\ *■ SCSI interfaces 

and can store 1GB- 5GB on a single tape! The downside is that 
these drives have a price tag to match; they usually cost over 
SAUS2000— a bit sttvp i , ■ r mj budget. However, these drives 
are relatively new to the market and as their acceptance 

is they displace fl* stems that the UNIX sites 

used lo use, the SCSI cartridge tape drives. 

A cartridge tape looks somewhat like an overgrown 
te tape. The physical size of a cartridge tape is 10cm x 
1 5cm x 1 .3cm. The two summon cartridge tape capacities 
60MB and 150MB. this size tape should cover most users 
needs, but what about the price? 

The dm i und SAUS1000 new, which is still 

sleep for the at erage user. I lowever, thesedrives, thanks to the 
"Exerbyte" and >A I drives, are , to turn up on the 

second-hand market I recently purchasi I Archive 

2150S SCSI cartridge tape dm. efoi (AUS295. 

For Australian readers, 1 purchased the drive from 
Unlimited Computer Supplies, 60 Hawksview St, Guildford, 
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installation 
formatting 
general setup 



phone 1 2) 892-2775. The drive had been lested by the 
| S nn d came with a three-month warranty UCS 
siitl had another 28 or so of the 150MB Archive 2150S drives 
left as weU as a number or 60MB tape drives (fiw under 

and a number of 150MB cartridge tapes forSAUSSO. 
All items were second hand. If UCS has sold out, check oil 
second hand computer stores or t . imputer equipment 

classified advettisments in your local newspaper 

The Archive 21 50S is classified as a 150MB/250MB tape dm e 
and can i • the f ol low ing ca r t ridge tapes: 

DC6150 (150MB) 
DC6250 (250MB) 
DC6320 {150MB) 
DC6S25 (250MB) 

The 21505 will alsa read the following tapes as well: 

DC300 

i\l 
DC300XLP 
DC450 
DC450XL 
1X600 
DC600A 

Lrive will actually write to the DC6O0/DC6O0A tapes and 
will s lit 120MB, bul VOU should remember that the 

DOiOO/I)C600A tapes are certified foe use in 9>trad 
drives and the 21S0S is an IK- track tape drive You should also 
be aw, iTi- thai the DC625C tapes cause the tape head to we 
such a way that eventually you may not be able to read /write 
the other formats, As a genera! ruleot thumb, stick to cmc 
format. The price for tapes themselves start at about SAUS30 
and go up from there. 

I had the drive, and lion the problem was how to 
hook it up to my system. My system consists ol an Amiga 2000, 
with a CVP Series 1 1 S< SJ < octtrolter a ud a Seagate hard drive. 
The hard drive is mounted on the controller card, meaning thai 
the large 5-inch bay in the 2000 was free; this is where I 
decided to put the tape drive. 

[f you have aln ed up the 5.25-inch b.n, on 

your A2000 or you b.n e an A500, A600, A 1 000, or A3000, you 



will need to get an external case for the tape drive. The external 
case will have to have its own power supph 1 he pi nver 
requirements lor a tape drive are rather high. The power 

marked on 2150S tape drive that I bought were: 

1 5 VDC, 17.5 I 

+12 VDC, 48.0 Watts 

Using what 1 remember of my high school i ks this 

works Out as: 

3.5 Amps at +5 
4 Amps at +12 

A power supply rated at about 65 Watts and designed 
to drive a 5.25-inch hard drive should do the job. NOTE: 
Phoenix Microtechnologies in South Australia advertises a 
"Phoenix SCSI I i may wish to contact them to see if 

this box is suitable for use with a tape d 1 1 \ i 

Before installing the tape drive into the 2000 (or 
expansion box) there is some preparation work to be done first. 
You will of course need some sort of cable to hook up voiU 
drive to the controller. The typo of cable will depend on 
setup. INK to be mounted in an external box, you will 

probably need a 25- to 50-pin shielded SCSI cable. 

If you are mounting the tape dm e internal to your 
computer, then you will need to obtain a il.it 50 conductor 
cable with 50-pin IDC sockets on it The number of sockets 
required and their location will depend on the number of 

in your computer (0,1,2) and their location. The cable 
and theconnei ton can be obtained from your local el 
store. 

When attaching die connectors to the cable, use a vice 
...■ (he connectors onto the cable; I tried the hammer 
method and broke two connectors before giving up and 
getting ,i , , i . competent technician to make the cable for me. 
If you do tr\ to build your own cable, remember that the kej 
on all the sockets should point in the same direction and leave 
extra room between the sockets just in case you need to reroute 
the < able later Make sure that when you install the cable that 
r roller is at one end of the cable 

Next we need to prepare the tape drive itself. This 
will involve the setting of several jumpers on the back of me 
tape drive, The jumpers d , i i, r from drive to drive so when you 
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Amazing Computing provides its readers with: 
In-depth reviews and tutorials 
Informative columns 

Latest announcements as soon as they are released 
Worldwide Amiga Trade Show coverage 
Programming Tips and tutorials 
Hardware Projects 
The latest non-commercial software 



Order a SuperSub and get this great Amiga peripheral 




AC'S GUIDE is recognized as the worlds best authority on Amiga 
products and services. Amiga Dealers swear by this volume as their bibte for 
Amiga information. With complete listings of every software product, hard- 
ware product, service, vendor, and even user groups. ACs GUIDE is the one 
source for everything in the Amiga market. 

ACs GUIDE also includes a directory of Freely Redistributable Software 
from the Fred Fish Collection and others. For Commodore executives, Amiga 
dealers. Amiga developers, and Amiga users everywhere, there is no better 
reference for the Commodore Amiga than ACs GUIDE to the Commodore 
Amiga. 

12 Issues of Amazing + 2 ACs GUIDES f 



A Great Reason to Get Into Your Amiga 




AC'S TECH offers these great benefits: 

The only disk-based Amiga technical magazine 

Hardware projects 

Software tutorials 

Interesting and insightful techniques and programs 

Complete listings on disk 

Amiga beginner and developer topics 



Call NOW for more information 

about these great Amiga 

accessories from 

Amazing Computing! 

1-800-345-3360 



buy your tape drive, try to get some documentation on the 
jumper settings for it. This article will use the jumpei 
of an Archive 2 1 505 tape drive as an example. 

With tin- tape drive righl way up, turn it around so 
the back end is fadngyou. 

The jumper block is what we are currently interested 
umper is slid over two adjacent pins on the jumper block 
to select enable an option or choice. When you buy your tape 
drive see if you can get several of these jumpers; the ones with 
tabs on if possible since they are easier to remove. An alterna- 
tive would be to take along this article and ask, very nicely, if 
they could set up the tape drive options for you, You should 
also be able to gp4 jumpers at your local electronics stores 

The jumper block on the 21 SOS is arranged as follows 
{same orientation as above) where each "| J" represents two 

pins 



( SERIAL | 


|CF2 


1 


|ID2 


[ Dl \G ] 


I CFl 


1 


[ID1 


| PARITY | 


|CF0 


1 


[IDO 



SERIAL ■ NOT USED. Do not jumper 

DIAG ■ NOT USED. Do not jumper 

PARITY - To enable parity you should place a jumper here. 

Whether or not this should be set depends on your controller; 

so check your documentation. Either every device connected to 

the controller has PARI I Y enabled or none of them do. In my 

setup no jumper appears 

I Selet ts the number < if bytes to be transferred over the 
bus. You may need to change this, explained below. 
IDO-3 - Selects the SCSI ID number of the tape drive; you will 
more than likely need to change this. 

First we need to set the SCSI ID number of the tape 
drive. 1 li. important thing here is to ensure that the ID 
number you set on the tape drive does not conflict with the ID 
of a devil I ocuneded to the SCSI controller. Most SCSI 

controllers use the ID number 7 for themselves, If you have a 
hard disk mounted intiotler card, the disk will usually 

use ID number 0. So you are lefl with a choice of 1-6. 

L nit number 4 is the usual number used for a tape 
drive in Amiga systems, however, the choice is n my 

m the tape drive unit number is 1. At the rime I selected 
the number I did not have a complete table of the tape drive 
jumper settings and I took a guess at which of the ID jumpers 
would select ID number 4 r 1 had a 50 percent chance of being 
righ.1 but I still gol it w rong! So that you will not have the same 
problem here is a table uf jumper settings for the SCSI IDs 0-6 
for the Archive 2 1 51 IS tape drive: 

lD2;oo oo oo oo [o=o| |o=o| [o=o| 
IDl:oo oo [o=ol [o=o] oo oo [o=o] 

IDfroo [o=o] oo jo=oj oo [o=o] oo 
SCSI ID: 12 3 4 5 6 



installed. 



Where "jo=oJ" indicates that a jumper should be 



The next option lo set is the butter size. This sets the 



number of bytes to he transferred over the bus tti a single 
operation When 1 first installed the drive, the size was set at 
2K and this seemed to work. However, in one of Thad 

Usenet News articles in the "comp.peiivi! 
newsgroup he points out that the SCSI "copy" command 
requires, a minimum of 16K and he recommends th.it the buffer 
size be set to 16K. I have followed Mr. Flor\ an 's advice and 
have since set the buffer size to 16K. Here are the jumper 
settings for the various buffer sizes for an Archtv e 21505 tape 
drive: 

oo oo oo oo [o=o| |o=o] [o -oj [o=o| 

CFl: oo oo [o=o| |o=o| oo oo [o=o| [o o] 

CF0: oo |o=o| oo [o=o] oo |o-o| oo [o=o| 

S1ZE2K 4K 6K 8K 12K 16K 24k J2K 

Now that the jumper block is configured we mi 
the terminators No, not the killer robots bm the resistors thai 
have to be installed in the last device in the chain of SCSI 
devices. The purpose of the terminating resistors is to slop 
"cross-talk," "reflections," and other electrical problems thai 
can not iu when electron!* signals are aenl m a long stretches 
of cable. 

On the Archive 2150S there are three terminators 
located in a row just above the SCSI connector, The terminator 
packs look a little like very small squashed sausages with eight 
pins sticking out the bottom (If you have a "CVP Series II 
SCSI /RAM Controller Card User's Guide" there is a drawing 
oi ,i terminator pack on page 7). On tape drives other than the 
Archive 2150S the terminators may not be in the normal pa ks 
but may come in packages (like ICs) or com 
ebeek the documentation which came with your tape drive 
before you start pulling bits and pieces off it. When you 
purchase your tape drive, try to get one with the terminators 
already installed. While they are easy to remove, they can 
sometimes be a pain to In 

As slated earlier the tefminatoi packs should be 
installed on and only on the last device in the chain. Gelling it 
wrong can cause all sorts of intermittent problems, so if your 
system doesn't seem to work properly after installing a SCSI 
device, double check the location of the termina tors. 

As the tape drive is the last device in the t h.nn. the 
terminators will be installed on the tape drive and only on the 
tape drive. If the hard disk had terminator packs installed they 
would have had lo be removed ©nofi the tape drive teas added. 
If you have more than one internal hard drive just make sure 
that whichever device is at the end of the chain has terminator 
packs installed and all other devices have their terminators 
removed- Nate: a disk drive mounted i m the controller curd will 
usually ton eck the documentation tluit came with 

your controller card and the hard disk. 

If you have external drives, then the terminate 
removed from all internal devices and installed in th. 
device in the external chain I know this is true for the GVP 
series II controller. If you have a different controller, check the 
documentation that came with it. So if your tape drive is nol 
the last device in the external chain or it is an internal drive, 
and you have external devices, then remove the terminating 
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resistors from the tape drive. 

Once the terminator issue is taken care of ive are 
ready to physically install the tape drive. Before starting, turn 
off the power to your Amiga and remove all connectors and 
the machine to a large, flat, and well-lit work area, To 
install the drive in the Amiga 2(XHi's 5.25-inch bay, \mi first 
need to remove the cover which is held on by five screws. Put 
the screws somewhere safe Once the cover is off you have two 
options: 

1 ) Remove the entire drive hay chassis. 

2) Attempt to install the dm i > chasis is in place. 

1 chose option 2) but I have been told that 1 ) is easier 
as it makes the mounting screw link's more accessible. 

Since I chose option -i. I had to remove the SCSI 
controller card to get at mounting holes on the drive bay; if 
you have other cards in your 20OQ, you ma v tun e to remove 
■i as well. Once 1 had the n trailer out I remo\ ed the old 
SCSI cable from the controller card and mv hard disk drive. 

I next attached one end of the new SCSI c 
tape drive and ted the cable through the drive bay 1 1 s easier to 
conned the cable to the tape drive before it is mounted in the 
bay. The SCSI connector on my tape drive was a hit damaged 
and 1 had difficult} plugging in the SCSI cable It turned out 
that some ol the pins had been slightly ben I and no longer 
lined up properly with the holes in the socket; I used a screw 
dm ec very gently, to bend the pins bade into alignment A 
wiser strategy would have been to return the drive for a 
replacement but I am a tad impatient. 

d ! I slid the drive into the bay. The tape drive has 
four screw holes which ie aligned with four slots in 

the drive bay. You may need to get somebody to hold the drive 
while you drive in the screws since the tape drive does not rest 
on the bottom of the Imv I obtained the mounting screws from 
of my junk box, but you may want to ask for the si rews when 
you buy the tape drive. Don the screws all the way 

up, since you will have to align the front of the drive with the 
front of the ftopp) disk drive B) taving the screws loose, you 
can mpve the tape drive backwards and forwards a little bit in 
the bay, allowing you to align the front of the tape drive with 

Wit of the floppy disk drive. This will then ensure that the 
front of the tape drive will be flush with the cover when il i 
replaced- Once you have the front of the tape drive al 
with the front of the floppy di lighten up all four 

screw ■- 

Connecting the tape drive to the power supph is 
simply a matter of taking one of the four-pin power connecters 
inside tha Amiga 2000 and plugging into the power socket on 
the back of the tape drive The power connectors are ke\ i 
they will go in only one iva) 

I I hen connected the SCSI cable to mv hard drive and 
controller and reinstalled the controller card Before putting 
the cover hack on the 2000, 1 removed the cut out for the 
inch bay in the front of the cover; this is held in place by two 
screws. 1 put the cover back on and plugged in all the cor 
tors, Then came the first big test ... I turned the power on 

The light on the front of the tape drive came on for a 
short period of lime, and the machine booted normally, a big 



sigh of relief. So the tape drive was now physically installed 
but 1 still had to con I igim tern and instal I som e si lit- 

ware before I could make any use 

m how you previously configured your 

ii, you ma\ have to ma ke changes to your hard disk 
configuration BO that the SCSI device driver software will be 
able to locate and identi t i he new tape drive. To check the 
config of your SCSI devices use the hard disk prepara- 

tion program that was supplied with your controller card. This 
program should be able to display information on all the 

1 1 1 n ec te d to 1 1 1 e co ntroller If the p rog m m does not 

that there is a device at the ID number you allocated to 
the tape drive, then you will probably need to make ■- 
i hanges to the * , ion ol the hard drives; it could also 

mean you have cabling, termination, or an ID selection 
problem but duK k the hard disk con figu rati en ■ 

To check on my hard disk configuration, I used the 
hard disk preparation program supplied with tin- ( iVP 
controller, FaaastPrep. and 1 went to the Manual Installation" 
screen Initially this screen shows the device at ID number 0; in 
my case my one and only hard disk. I then clicked on the ">" 
gadget to increment the ID number and I cycled through all 
the ID numbers but no other dc Hi shown. Obviously 

something was not correct. I clicked on the "<" gadget to 

emenl the ID number back toO to double check the 
configuration of my hard drive and there I noticed a possible 
cause of my problem; the "Last LUN" (LUN = Last Unit 
Number) and "Last Disk were selected. These two 

tons when selected inform the SCSI device driver that the 
device at this ID numbei is the highest de\ ice number con- 
nected to the controller. In my case, this meant that the SCSI 
software would not look N devices with an 1 1 ) 

ber higher than 0, so the software could not locate the tape 
drive which has m\ ||] of 1. To remedy this, I deseta ted the 
"Last LUN" and "I asl I fait ' option foe device number and 
wrote back the changes. Then I rebooted my machine. 

This time it took longer for my system to come up. 
The reason foi this dela\ is that when vou boot your - 
ICSI controller goes out and polls all the device ID 
numbers from 0-6 to see which devices are connected, It will 
wait a certain amount of time before it dec ides there is no 
devit i iven number. Previously my system would only 

poll device number (J (since this device number had been 
selected as being the "Last LUN" and "List Disk"), Now, 
however, the controller pulled all device numbers from 0-6 and 
this takes longer (unfortunately you can't make a tape drive 
the "Last LUN" and "Last Disl 

machine was rebooted, 1 needed to check to 
see if the tape i i ive was now shown as being connected to the 
controller. Rather than use FaaastPtrep again, 1 thought I would 
try out the hard disk preparation program supplied with 
AmigaDOS2.0, HDToolBox, 

To use HDtoolBox with rmn-l mnmodoreSCSl 
controllers, you have to inform HDToolBox of the name of the 
device driver that is used with your SCSI controller. To do this, 
you set the HDToolBox icon tool type "SCSLDEV1CI \ A \ 1 1 

to the name ol the de\ ice driver. For instance, to gel 
HDToolBox to work with a GVP controller, select the 
III fTbolBox" icon, selet I "Information" from the VVorkBench 
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2.0 "Icon'' menu. When the "Information'' u indow is dis- 
played, click on the "\. iter 

:CE_NAME~gvpscsi. device 

Thin click on save. 

\\ i -ii i LJmahU'i Ik ked on the f tDToolBon toon and up 
ame a lisl cmI 11> numbers and associated drive types. My hard 
drive was listed but there was no sign of the tape drive, all the 
other 11 ) numbers showed "unknown" as the drive type. Now 
to sat i' you the trouble that I went through recheeking every 
thing .ind having a rninor anxiety attack, I will quote a line 
trom the "MDToolBox" section of the AmigaDOS 2.4 manual, 

"SCSI tape drives are always listed in Drive Type as 
unknown" 

However, 1 have heard from a person with a Commodore SCSI 

'Mt. r that his connected tape drive is listed when using 
HUTbolBox; so the pniblem may be with the GVP controller 
and /or software. 

I resorted to using TaaastPrep" again. I went to the 
"Manual Installation" screen and diked on the ">" gadgd to 
increase the ID number and sure enough there al ID number 1 
M as ..in entry few the tape drive. It .showed the name as 
ARCHIVE" and the manufacturer's ID as' VIPER 150 21731", 

The next step was to try to write, then read, data from 
the tape. To do this, I decided to use the hard disk backup 
program supplied with AmigaDOS 2 1), "HDBackup". This 
turned out to be a mistake since "HDBackup" and a related 
program "BRIT seem not to work with tape drives which are 
connected to i non-Conunodore SCSI controller; me b 
appear to get written OK but any attempt to read the tape 
results in a complete lock up ol the computer. 1 have sent 
electronic mail to Commodore and a fax to ( EVP describing me 
problem. GVP replied to say thai the problem is with "BRU" 
and that a new version will be released. In l ..--.- you h.n. y ,j 

nodore SCSI controller (A2090, A2091, A590, A3000) I am 
including the steps required to Configure "HDBackup' 

"I IDBackup" is in tact a graphical front end to 
another program supplied with AmigaDOS 2.0 called "BRU". 
"BRU" is a hard disk backup program that a I tin from the 
Shell /C LI. To get "I IDBackup" to work, you therefore need to 
.ii rt- "BRU" as well as "HDBackup". 

To configure "BRU," you have to edit the "BRU" 
configuration file "s;BRL"tab", Find the entry in this file which 
Starts with "tape:". Then replace the field "device = 
scsi, device" with, the name of the device driver supplied with 
your SCSI controller. If you have a Commodore controller you 
don t need to change this. GVP users would use "device = 
gi psesi device ' It the ID number you selected for your tape 
drive was a number other than 4, then you also m-nl tn change 
the unit = 4" entry. On my system the tape drive ID is 
currently 1 so the BRU tab entry had to be ( hanged to "unit - 
I". You can also do the same thing for the "ntape:" entry. 

"ntape:" is a non-rewinding version of "tape:". If you 
ivrn- to select "ntape" js the device to which "URL / 
HDBackup" writes the backup archive to, the tape drive would 
not rewind to the beginning of the tape before writing out the 



archive. On the other hand, had you selected "tape as Ihe 
output device, then the tape drive would lirsl rewind the tape 
to the beginning before writing out the archive. 

The device specified in tin- first entry in the 
"s:BRUtab" is used as the default output device by ' BRU". So, 
if you want the tap to be the default backup device, 

■ the entire 'tape:" entry to the top of the "s:BRUtab" file. 
To configure HDBackup, you need to add the 
following Uh>1 type to the HDBackup icon: 

■pes I ntape; 

If you want "HDBackup" to use Ihe tape drive as the 
default backup device add the following tool type after the 
"DEV5" tool type: 

ape: 

Save these changes HDhWkup/BRU" should now 
be configured, and if you don't have a GVP controller, they 
may even work! 

I laving a tape drive is not much use u ithoul having I 
way of writing/ reading tapes, so I started to Soofc al my 
Options. The first was to buy a commercial backup program. 
My next option was to check the wonderful world of public 
domain software to see if there was a solution available there, 
After scanning the Fred Fish catalogue I found a program 
called "BTNtape" or the "Better Than Nothing" (ape handler 
This program is a device driver for a tape drive. It allows you 
to access a tape drive in a sin iu would other 

devices. There are a number of versions of this program 
around and the earlier versions do have pre I make 

sure you get al least version 2.1 (Fish Disk 558), 

n stall the tape driver, copy the file "bin-handler" 
to your "L:" directory and then edit the file "dev&MountUst" 
and add the following entry: 

TAPE; Handler = L:btn-handler 

Priority 

Stack 4000 

GlobVec = -1 Startup 

-gvpscsi.device/U(N-l/BT-4/'KB-32'' ■ 

If you want the "tape:" device mounted automatically when 
you boot \ m insert the line: 

Mount 

m me above. You may need to change the "Startup" line. The 
"gvpscsi.de vice" should be the name of the de* k e driver 
supplied by the maker of your controller card; i.e. Commodore 
controller users would use ' 'scsi.de vice." I he "UN-" entry 
specifies the ID number of the tape drive U your tape drive IF) 
is set 4, then you would use "UNM." If you have no histKAM 
(or you are not sure) then you need to set the buffet memory 
type option to 2 (BT-2) to select Chip RAM. To mount the tape 
use the command: 
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V-' tpe in the drive and try to cop 

to the tape with; 






The tape should make some noise and the light should come 
on; it may have lo rewind the tape first so be patient. Once this 
has been completed, change to another directory and enter: 

copy tape: TO 

The tape should again make some noise and evenlu- 
vou should be left with a copy of tlu- original hie in the 
I urn in directory. If you have any problems, double check the 
MountList file, fix it if there are problems, and remove the 
incorrect device with; 

assign tape: REMOVE 

before mounting the fixed version with; 

mount tape: 

If you still have problems, check the documentation 
that came with BTNlape to see if there is anything special thai 
i be done for BTNlape to work with your SCSI controller. 
The "tape.' del ice is a streaming device which means 
thai it doesn't support a filesystem. i e it doesn't support 
directories or even file names. So you cannot copy to/ from 
"tape;filename". You can, however, modify the behavior ot the 
tape" device by referim, la the tape" device with keywords 
ed to the right. 

tape: will rewind the tape to nning and starts 

the read /write operation from there. tape;NR starts read/ 

operations at the current tape position, tape AIT g. 
the end of the last written file and starts the write operations 
there. Hunk of (his .is .in append operation It does not work 
with all drives tape nurn Starts a read operation at the file 
specified by the number The first file on the tape is number 0. 
e these I nmmands would allow you to read and 
write any number of files to the tape, it would be a majoi task 
trying lo keep track ot which files are located at which paw 
tions on the tape. It would not be a very good solution for a 
backup system by themselves, There's a better w.n 

There is a program called "tar" (Tape \rchiver) which 
originally written on UNIX machines to handle exactly 
this situation, "tar" will back up any number ot files including 
entire directory trees to a tape in an archive tile. Using "tar," 
you can access the files in the archive by their names so you no 

: >. vJ to know where the file is located on the tape The 
author ol !5T\tape," Rob Rethemeyer, recommends the 
vers, . ,-" ported by Jonathan Hue which can be found 

on Fish Disk 44? "tar" commands have the form; 

rtory names] 

where the [flags] are a group of letters preceeded by a "-" 
which Specif) the type of operation to be applied lo the archive 

file, |archive_name|. 



The most used pa 

c - create the archive (archive_name| and &<Ad all the files and 

directories specified on the command line to it, 

f - Tells tar to u i name as the name ol i In- archive, 

tins a re hi ve_ name could be a file name it vou want to write 
hive file to a disk. If you want the archil e file to be 
I on the tape you should use "tape as the 
archive_name. 

t ■ lists the contents ol tin- Mr file 

rbose mode, tar prints messages to explain what it is 

doing, 

x - extract the files from the p 1 1 

For example, to back up a directory Structure 
could List 1 tin- lol lowing command; 

tar -cvf tape: dir_name 

where dir_name is the name of the directory you want to back 
up. "tar" it ;. I [rector) name will do a "recursive" 

backup - that is it will copy all the files in the specified 
directory and the dire* tones below it to the arcln 
If you wanl to see what is in the archive fife 

tar -tvf ' 

will list the table of contents of the archive. To restore the 
directory structure fi 

tar e; 

I f yo U nt to restore a single fib 

tar -xvf tape: path/name 

To archive an entire partition, s&j 1 1 1 i . change directory to 
FIDO: and enter: 

tar -xvf tape: "" 

This will write the entire partition to the tape while 
you can go off and enjoy a Coke, 

"tar" has many moi than are discussed here; 

to find out more read the "t.ir.man" file that comes with the 
"tar " program on Fish disk 445. The "tar" program on Rsh 
disk 445 is compatible with the "tar" program in use on many 
computers running the UNIX operating system. Using 
"BTNtape" and "tar," I have been able to backup up entire 
directory structures on my Amiga, then take the tape to work 
a nd read the d i rec tory structu re o f f the I 
program and tape dlft e on a Sun SPARCslation; the reverse 
works too. 

The documentation which comes with BTNtape has 
information on the use of "tar" as well as the "btn-haiull 
also includes many helpful hints on how to manage vour 
backup tapes. I hese include a reminder to always label VQIU 
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tapes with their contents and the date the tape was written, 
Always do a " tar -tvf tape:" command att> 
archive, since this will check the integrity of the tar archive as 
well as listing the contents o0 the archive Make up a floppy 
boot disk which has the "btn-handler" installed on it, then in 
the case you cannot boot off your hard disl |p|e to 

boot off this floppy and restore the hard disk from your 
backup tap ( H course you have to make the backups for this 
to work, 

I low often you backup your system will depend on 
how quickly things change In you you 

partitioned your hard disk. For instance, I have a work 
partition which changes a lily while I 

partition goes for weeks, even months, without major change. 
To handle daily updates, I still use,] floppy, I keep a flop] 
disk in dfO:, to slop the drive from clicking, and at the en 

ion'' I copy the directories I have been working on to the 
floppy disk. Now that my tape dm e is set up 1 am considering 
doing a complete backup of my system (all partitions) once a 
month and a weekly backup of the work partition 

So that is it; with the addition of a SCSI cartridge tape 
drive, "BTNtape," and "tar," I have a workable backup 
solution which, while not perfect, at least lakes much of the 
drudgery out of the process, "tar" is not the most user friendly 
of backup programs, but it does work and is reliable and 
very useful if you need to exchange data with UNIX systems. If 
you would like a program with a graphical interface you 
should look al a commercial product. Or you could wait 
.m hi u- because ! plan, when I gel tin. time, on writing some 
ARexx scripts to automate and manage my backups for me. So 
keep your eyes open for a future article and in the meantime. 



back up those h, 

It you have access to [net, or Internet you 

can contact me by electronic mail, my address is 
"paulg@tpIrd.tploz.au", 
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A Tape Drive Utility 

Included with the BTNtape software on Fit i8 is a 

small utility program which aids handling of tapes. The 
program is written in ARexx and is called "tape.rexx". 
This program allows you to rewind, retension, and erase 
tapes. To install the program, simply copy it from the fi*h 

i your KliXX: directory To run "tape.rexx," 1 enter 
the following; 



i x ■ ape 



w here 



device - is the name of the tape de\ uv is spei rfied in your 
nu umiUst but without the ";" The default "tape" will be 
used if no name is supplied. 

cmd - can be one of the following; 
BACK - skip back oni 
END - goto the end of data on this tape 
ERASE - erase the entire contents n! the tape. 



FORWARD - skip forward one tile 
RETENMi >\ this will retension the tape by going to 
the end of the tape and rewinding to the 
beginning. 
REWIND - will rewind the tape to the beginning. 
WFM - Al the end of each file (01 tat archive] a file 
mark is written to the tape, This command 
will allow WLi to write an additional file 
mark for the systems that need them. 

For example, to rewind the I drive mounted as 

"rsttl" you would use the following command 



—Paul Gittings 
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Entropy 



in 



Coding Theory 



by Joseph J. Graf 

Many people believe the goal of data compression to 
be the removal of redundant data. This belief is not entirely 
true. The goal of data eompression is lo express data more 

ientlv h ithout losing information, which has the effect o( 
removing redundant information. 

The Huffman method of data compression uses the 
frequency of information as a basis of symbol generation; the 
more frequent the value, the shorter the symbol size, For 

pie. the letter A is more frequently seen in text than Q so 
A would use fewer bits to represent than the tetter Q. 

The Huffman model of data compression is based on 
the coding theory of Shannon, You need not know the full 
implementation of the Huffman scheme to determine the 
compressibility of a file. Shannon's entropy formula calcu- 
lates that for you. 

Entropy is defined by Webster's New Collegiate 
Dictionary as "a measure of the amount of information in a 
message that is based on the logarithm of the number ol 

ible equivalent messages." The formula to determine the 
actual amount of information contained in a message is -(p * 

p), where p is the frequency of a character in a file. Since 
we are working in bin;ir\ instead of base 10, a logarithm 
function that win k n base two is necessary. From calculus, 
the derivation of a base n logarithm function is as follows: 
logn X ■ log 10 x / loglf) n, This is the same as logn x = log 10 
x * ( I / log 10 n). We want to do as few computations as 
possible for speed, so a little calculator work yields the value 
of 3.219 for (I / loglO 2). The new formula is log2 x = loglO 
x* 3.3219. 

The entropy function is in terms of x, where x is the 
frequency of any given value. To determine the frequency a 
value has in a file, divide the number of occurrences of the 
value by the size of the file in bytes. Use this value for x in 
our new log function and you have the entropy loi thai 
particular value. A tally must be kept of all values' entropy, 
which in the end will yield the compressibility of the file. 



The first program (Listing I i calculates the savings 
potential using an order-0 compression scheme, An order-0 
scheme looks only at one value at a lime, an order- 1 scheme 
looks one place ahead, order-2 looks two places ahead and so 
on. The higher order methods require more processing and 
more memory to perform compression, although the compres- 
sion ratios grow larger. 

The second program (Listing 2> calculates the 
entropy of a file for an order-2 method. By noticing the small 
differences between the programs, the code can be adapted to 
determine the compressibility of a tile for an ordcr-n scheme. 



Order 



QRDERG by Joseph 



(♦include <stdio.h> 
# include <math.h> 

■ trie max 256 

FILE -ir.f 

unsigned in - . '.'AX] ; 

long size; 



void file_read(name> 
char *name; 



char ch; 



iff! pentname, "r") } I 

pr: Couldn" 
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Is! !\n*,name> ; 






11 lei <ch = getc(iiv EOF) 



table [ci. 



size ■ ft ell {in] 

f closet input t ; 

return; 



double calc_entropy ( ) 

double entropy = 0,0; 
double freq; 

;nt i; 

for(i = 0; i < MAX; 
I 

• ; table; i 

< 

freq - |dc 

entropy -^q • 

eq ■ 1 .3219)); 



I 



retu: jpy) ; 



argc p argvl 
int m 
char *argvf 1 ; 

i percj 

; larg 

printf t " ''. n'Jsagt- : 
exit (0| ; 



filename 



I 

■I (*\n\nReadinq. . . 
f i le_read (argv [11); 

t£ ( "Determining rat ion. . , 

entropy = calc_entrc; 

perc •100) 



<"\n%s has an ord 



syte. ", entrc: 
uld 






ere); 
return (0) ; 



Order 1 



•'• 



by Joseph J Graf *******/ 



e <stdio.h> 
^include -cmath. 

^define MAX 256 

E •inputs- 
unsigned int table [MAX] [MAX] ; 
long si 



id (name! 



t r ch , < 

: (input - f open { name ,* r " )) ) 
( 

printf(*\n Couldn't open file 
%s! ! \n" , 

exit (0) ; 

while! (ch - |ei input)) && (ch2 = 
getc( input) ) != EOF) 

table [ch] [ch2]++; 
) 

input ) ; 
fclosei; 

retu 
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double entrop , 0; 

double 

register i: 

for I i 

fort ; MAX; j++J 
( 

jl ) 

I 

fro 

(double) table! i ) [ j] / s 

entropy + = -(fi 
• 3.3219 

) 

return \>yi ; 



char *argv 

double entropy, perc? 

iff larn | (argc > 






8 



print f ("SnUsage: order 1 

; 



nReading. , 

tti os 

entr ; calc.entr 

perc = (100 - ((entropy * 100) / 



pri: der-1 entropy 

,argv[3 

prj if %2.3f bits per 

. \ ■ 
pr- ."; coding would 
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A Fast Plot Library 



by Michael Griebling 
Introduction 

For some lime now 1 have been M-arching for a general-purpose 
plotting library that is both easy to use and offers fai rl i< ,ned 

ionality which can produce professional -looking graphical plols. 
Commercial packages are generally too specific (i.e., business graphics 
only i in be used In a wide ra^ge °f applications and also are fairly 

AREXX plotting libraries would be another alternative but they 
' -rpreted and tin -iderably slower than a custom 

ire package, m addition, the plotting capability should be easy 
■;rate into other programs with very simple* .ill>and a minimum 
' at Library package meets these goals with the 
folio- res: 

produces bar charts,, linear, curved., scalier, logarithmic and semHoB 



fast due to the use of a compiled language t Modula-2) 

ixnbei ui plots on ■ custom screen with up to 32 colours 
malic *■ and y-axis labelling or user-definable labels 
automatic grids 

automatic local minima /maxima labelling 
bo* 
able lex t / line colours 

Some sample plots produced by the riot Library routines are 
shown in Figures 1 to 5. The program in Listing I produced these 
is tmg 2 is the complete source for the Plot Library 

module Listing i shows the source tor a suppnrt module called 
String I 

The n i this article demonstrate* how to create your 

dm n plots b) walking through the program in Listing I and describing 
the PIotLibrary routines, as needed, to give a basic understanding of 
how lo use them. 

Creating Your Own Plots 

■o call the [nil Plot plot routine with a set ot 
arguments which define the plot characteristics SS folk 




PROCEDURE 
VAR Plot 
MainTitle 

PlotKmd 

xMin, xMax, yMin, yMax 

width, height 

xDiv, yl kf^ 

xSubDiv. ySubDiv 

NumberOfColou rs 

: BOOLEAN; 



InilPinti 

I '1, 1 1 :■>. j'r 
; ARRAY OF CHAR; 
PlotKindTvpe; 
XI- V . 

INTEGER; 
: CARDINAL 
:CARDI\A| 
: CARDINAL, 
: CARDINAL) 



Figure One. 



where the Plot is a variable which is used as a handle to id* 

specific plot; MatnTitle is the title which appears at the top of' the plot; 
PlolKind is one of 

1) normal (Figure l)plot continuous cm 

2) line (Figure 2)pkri points connected with line segments 

3) bar (Figure SJbars of various heights, 

4) log x (not shownlplot the log of I he it-axis 

5) log y i not shown)plot the log of the y-axts; 
ft) log-log (Figure 4) plot the log of the x- and 

xMin, \M,i\. j Mm, and yMax define the real-world plol window; 
width and height define the screen din. I the plot in pixels; 

xDiv and yDiv give the number of divisions in the x and y dire* 

eO values disable the grid; xSubDiv and ySubDiv give the 
number of subdivisions in the x and y directions, xDec and yDec gn e 
the number of decimal places used tor \ and \ labels; and 
NumberOfColou rs gives the maximum colours desired on a 
plotsubject lo some limitations discussed later. Scatter plots (Figure 5) 
arc special in that they are produced by plotting character sy mi 
each graph point ins tea ing the adjacent graph points with line 

segments. These plots are described in more detail Liter Figure 6 
illustrates the difference between the real -world coordinate 
the pixel Coordinate IVStem inherent in the Amiga's graphic utilities, In 
effect, the real-world coordinate system defines the domain in which 
the plotted functions live For e ■ plotted sinusoidal wave in 

Figure 1 has an x-range (xMin to xMas i of D tO 7 and a y-range i - 
to yMax) of -1 to 1 . This real-world space is mapped onto Ihe Amiga 

n within the pixel space defined by the width and height 
parameters passed to the InitPlot function by Ihe xyToCoords 
mapping fu nd i on in Listing 2. 

If InitPlot returns a TRUE value, the plot has been successful]) 
initialized and Ihe plot can be drawn using the PlolFx procedure. This 
routine takes two arguments: th* I plot handle which was 

defined by the InitPlot function; the second is a function which takes a 
real number (x) and returns some value F(x}, Eight different functions 
are defined in I >siing 1: Dam pSine, Cubic, RandomSme, 
•\ nip Modulated, Response, SlockPnces, Profit Values, and 
Profit Vatues2. As you can see from these examples, Ihe process I 
performed by F(x) varies somewhat depending on the kind ol plot lo 
be drawn. Normal, scatter, log, and semi-log plots can accept any 
continuous function, the bar chart and linear plot require ,i cUst reti 
function which returns one value for each bar or point on Ihe linear 
plot, 

Congratulations, you have Successful)) produced your first plol! 
And it took only two calls lo routines in the PIotLibrary! Of cot 
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this first plot can be enhanced in a number of ways which include 
labelling Hie plotted minima and maxima, displaying in information 
box, changing text line, md screen colours, adding your own ■ 

labels, and plotting multiple functions on a single axis | 
each of those special e 1 

Special Effects 

I remember being in school and having 10 determine the local 
minima and maxima oi functions by taking the first derivative of the 
•unction '■ ■ ibetMinMax nam k thai and then 

labels tin null i ight on the plot. LabelMinMax takes the 

arguments which vou also passed to the PlotFx procedure You 
illy call LabelMtnMax righl after calling Ptotl-x but the calling 
order could be reversed if you want the plotted t tin > to overlay the 
minimum/maximum point labels. UbelMinMax works , 
the plot types defined in the Plot Library For the scholarly reader, the 
local minima and maxima am determined by looking for sign reversals 
of the den vati\ e of the plotted functions. In school you solved this 
same problem by de-term i n i ng w he re the da « slope) was 

mtoj however, with computers., tests against zero doi work 

so the sign reversal approach gives more consistent n 

InformationBox routine provides a powerful mechanism for 
displaying details about the plotted function, The preceding plots 
demonstrate the use of the information box, Tou- mnatiun 

rray of strings {1 exported from Plot I 

for this purpose) whh i enough elements to hold all the lines 

ofdispLe, h omple, to display live lines vou would declare; 

Message : ARRAY (1 5| OF Line I 
and initialize this array with the information to be displayed in the 

[nation box Hits inlormatton box can be positioned" in the upper. 
i r lower plot area ind can be centered, left-justified, or right-justified 
in the plot icgion Both the information box's background and outline 
colours are specified in the call to InformationBox; text colour is set by 
the SetTextColour routine described Mow. The SdentifkPkM routine 
in Listing 1 whose plotted output is shown in Figure I demonstrates 
how to use the InformationBox routine. 

Ines handle the colour manipulation of the plotted 
output SetColourMap changes which of the 40% available colours get 
mapped to a subset of colours available for the plot screen An eight- 
colour screen would allow you to select eight of the 4096 1 otours to be 
displayed at one lime- Each call to SetColourMap sets one screen 
colour, SO eight calls are necessary (O full) define all the colours for the 
example screen although unused colours don't need to be mapped. 
ing names for the colour in pa you to remember which 

colour i mapped where. The declarations in Listing 1 define a set of 
constants like Red = 5 so that a call to SelCo!ourMap(Plot, Red, IT 0, 0) 
can be used with a colour name instead of a number "Pie last three 
arguments define the amount (0 to 15} of red, green, and blue, 
respectively, for screen colour six (the first • these eight 

colours to define U> hu iSei'l exit olour), the plotted 

curve coloui (SetPlotColour), and the grid coloui [SetGiidColourL In 
eacl -Mke. as an argument, the colour number 

(from to 7 for an eight-colour screen] A maximum oi 32 coloui 
be used with a pint screen width of ^20 pixels; 16 colours for a < 
pixel plot screen width. 

The x- and \ -axi> titles are positioned using the CenterLabelX md 
Center I .a he I ii procedures. Both these routines automatn ,ilk center the 
text horizontally for CenterlabelX and vertically for Contort j| 
You only need to specify the vertical position <in pixels) for the- x-axis 
label and the horizontal position (a 1st* in pixels) for the y-axis label As 

-. the horizontal pixd numbers increase from k 
right and the vertical pixel numbers increase from top to bottom. 
Some experimentation may be return 
although the positions shown in the BarQuul routine in I i-lmg 1 (395 

id 13 for y label} give a gixxl starting point, Note that these 
labelling routines are i I to axis titles but could also be used 

lering other Information anywhere on the plot. 



LabelX and Label Y are two more general labelling pi 
which give you control over bi tit the x and y position of plot text The 
only difference between the two is that LabelX produces a horizontal 
line of text while Label Y pn I text display, The Amiga 

Operating system (VI. 3) does not allow text to be rotated so the vertical 
text is composed of unrotated characters, each offset vertical!) trom the 
others. Rotating characters for lb i non-trivial task III leave 

•ther time. 

The last text labelling procedure. Set tjbel Routine, lets you 

Ida the numerical labels which are automatically generated by the 
Plot Library. The example in figure 3 uses this routine to produce 
month labels for a bar chart, This example passes the Bar Labels 
procedure (Listing 1 ) to the Set LabelRou tine [usl 1 1 ing the 

PlotFx procedure. The passed procedure must have an interface 

si to the one shown for the BarLabels procedure. Tht 
argument identifies the plot division lobe labelled and the second 
argument returns the corresponding label string, Currently, only the 
wim-, labels '.an be overridden, although it should be fairly sample for 
you to add y-axis custom labels by duplicating the source code shown 
for the x-axis custom lal 

Another procedure, SetScatterPlot, overrides the line-drawing 
modes of the standard plots and allows a character to be plotted 

I for each point of the original graph. The default character b an 
O' but you can change to any other character using the SetScatterChar 
routine Th* plotted scatter character colours are changed with the 
SetPlotColour procedure. Figure 5 shows the output ...I ■!',• ScatterPlot 
lure from Listing L 

The BarChart procedure in Listing 1 illustrates a method of 
plotting two data sets on the same coordinate axes. The first bar chart 
b created normally u was outlined above with a slight twist: the 
SerPI* «H 1 1 1 nes is used to offset the ba rs by four pixels to the left 

of where they would appear by default lb* second bar chart uses a 
second data set whicl i .ur pixels to the right of the default 

position using the same SetPlolOffsel procedure just before calling the 
PlotFx routine. This bar chart also demonstrates the power of pi 
a function (Profit Values or Profit Values2) which is called dunng the 
plotting operatfori since 1 1 iloun are set dynamically as the graph is 
plotted. In this case the plot line colour is changed with SetPlotColour 
■luce black and grey bars for a positive profit and red and pink 
B profit Injure 3 shows the resultant bar chart, 

The Sel ■: procedure a*, used to give pixel oil 

N position the bar charts described above. A negative pixel 
passed to the xoff argument shifts the plotted function to ttv 

bet shifts the plot to Che right A negative pixel . 
passed to the yof f argument shifts the plotted function up; a positive 

•if set shifts the plot down, 
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Any number of plots of my kind can be overlaid on the same ptel 
as long as their n ms arc ecguh alert (i.e., both 

batch 
thousands ol dollars for the y-axis) Overlaid plots are usually not 

i other except wlien you waul to produce three- 
dimensional effects or bar charts. By adding offsets i owPloi 
routine in Listing 1 and changing thi tine colour, a plot wit 
-.!...,.!,,.,., for emphasis ed 

> uu now know how to overlap plots which share the same world 
coordinates, but what aboui prod ikh use different world 

coordinate systems 7 Fortunately, there is a simp ■ U the 

SetPlotLimits procedure i* used. This routine modifk 
real-world coordinate points to the pixel coordinates requited bv the 
Amifri'» display B) specifying different plot limit-. Jrom those 

i to me EnrtFlot routine, we can dynamically change 
our window size to accommodate larger or smaller plotted fund 
the mm plot v, Indow 

tied procedure called SetPlorScale in Listing 2 allows us to 
magnify the cenirr of the plot by an arbitrary amount, 

The Scaled Plot procedure (Listing 1) pro* ii unple h hkti 

1 1 DCS i USl this A cubic curve is shown at d i r 1 1 
the same set of axes (Figure 7), 

labels correspond to the first plot and only 
represent a scaled version of the magnified plots. I he plot scale Fa* tors 
passed to the Self rocedure must be vah (reafer 

than 0.1- Numbers less than one actually i rule 

numbers greater than one enlarge the plot. In this case the cubic 
function's v- and y-axis have been selectively magnified by two. The 

enlarged plots have been magnified more than can be shown m the 

plot window to demonstrate the line clipping algornti i 

PlotLib: 

As a final example, tour independent plots (Figure 8 

uvr '. pn ..i. lure called InitOfrsetFtol us used 

by the QuadPlol procedure in listing 1 to place multiple scaled ; 
on the same screen, The initial steps are the same as before A pint is 
initialized using EnitPlot I h is first sh p i mates the canvas for the 
following lour plots so the maximum number of colours and maxi- 
mum pixel screen sue need to be specified in this call. The second step 
requires a call to IrutOffsetPlot with a reduced pi iboul 1/4 of 

the total screen area originally specified to give room for four plots 
The call is to a new routine: 



PROCEDURE 

Plot 

Plot Kind 

xMin, xMax ••, Mm, \ Ma* 

width, height 

\l>tv, yl>iv 

xSubDiv, ySubDiv 

xDec, yDec 

wQfrset '.offset 

OldPl 

:Bt 



etPlot( 

REAI 

.IVIH.I-K. 
: CARDINAL; 
; CARDINAL; 

DINAI 
: CARDINAL; 
T'JotType) 



VAR 



The three last arguments in this procedure differentiate this 
routine from the call to Imtt'lot where xOf fset and y< ' ry the 

plot offset relative to the pixel coordinate origin at (0JB) in I 
screen corner; and OldPlot is the plot variable initialized when InilPlot 
was called. The number of x an- i I s should also be cut in half 

since less text is visible in the reduced display area. The subdivisions 
have also been elimina ted to avoid C I utteri ng thi 



From top to bottom, Figures Three through Five. 



Enhancements 

A number of enhancements can be made fairli easily to the 
lo extend its capabilities Ihese are 
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I) Automatical!) determine the plot minimum/maximum points for 
toe J m't have to know I hew vaJhii 

Mining columns to numbers to be used as the 
function to be plotted, 

ed text. 
■II Implement a pie chart plot 

Thee new capabilities require a bit more work, but iU these 

additions would extend the USCt 

rivals the commercial plotting systems. It there is enough interest HI 
tickle these additions in a future article. 

Compiler Dependencies 

I he Plot irce code was, compiled u*ing d* 

pilei and any dependencies- Um e been flagged in 

the source. Spa nReilTrani 

(big point function 
library. Other compilers may provide this access automatically. All 
other Modula-2 specific calls should be av.nl.ible in other compilers 
The Amiga system module names and fun. differ slight!) in 

your compiler but should be similar to l ho- 1 

provided a StringUtils package to give a string length function and 
allow conve n floating p e operations 

an? included because > ; ePIotl Ebrary and m 

be provided with ever; Modula-2 compiler- If you have diem 
feel fro i" substitute your own. 
Ifyo M-- language is C", you should have no problem 

translating from Modula-2 to C and several conversion programs can 
even perform the translation automat i. 

Conclusions 

The Plotljbrary pro', t ol routines which greatly simpli- 

I i Isuatizing data tor students, scholars, bus 
execul . pen mi'nters. Simple plots can be pn> tfijusl 

ilU but more elaborate capabull i able to produce an 

information box, Label plot minima and maxima, place lest and tides, 
overlay ptol pla] multiple plots on i sin 

in capabilities are powerful enough to unleash the imagination of the 
PlotLibr.irv user I lave fun! 
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From top to bottom, Figures Six through Eight, 
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xKLd, )•**« 

, 01V 
kS at-J : v , ySubD I v 
Kdec, yQec 
■Offa«t r yOffaat 
OldPlot 



Plot ! Pi-'. 



t CA !• 






nonality 



t PlotTypei 
: Poll ti an Type s 
i ARJUY Of LtrarTypa; 
: CAHDIHAL; 
BALI J 



MBXEDUBE PlotLllwlPlOt 

Colour 



ryp«; 

i CAR0TNM.I 
yJ r MAX. I I 






:.LTyp<I 
>Kkn, HXtx. yHin, yHM 1 PEALl j 



[Kdi, yicala i P£Aivl : 



■KCCXIM SwcPlotaffaat (Plot 

»a(E rTKGEHJ; 



. HI I CARD] 



y 






Typ#.- 



vp*i 



ut. 






Listing Two 



iKPLEHOrrATlOl HPTW PlOCL-lt 



•nrHdr 



mON EYfTW 



i - H | 



«s aodul* ctoveloj)*! to nipt- : 



i-.. . . 



PJotType; 

cmd : ' 



(Plot : Pitxtiypai 

On : K" 






iPloc 1 PlotTjTMJ 
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PROCEDURE L- U.I t WUU-; 

BEGIN 

I .turns iJiaaal 

■-.', 2.1; i* «nd ret iu 

END) 

END L.:- . 
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—The complete Source Code and executable files 
may be found on the AC'S TECH Disk 



Please write to: 

Michael Griebling 

C/O AC'S TECH * 

P.O. Box 2140 

Fail River, MA 02722-2140 
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GOTTA 
GETTA 
GUIDE! 




Looking for a specific product for 
your Amiga but you don't know who 
makes it? Want a complete listing of 
all the Fred Fish software available? 
Just looking for a handy reference 
guide that's packed with all the best 
Amiga software and hardware on the 
market today? 

If so, you need ACs GUIDE for the 
Commodore Amiga. Each GUIDE is 
filled with the latest up-to-date- 
information on products and services 
available for the Amiga. It lists public 
domain software, user's groups, 
vendors, and dealers. You wont find 
anything like it on the planet. And 
you can get it only from the people 
who bring you the best monthly 
resource for the Amiga, Amazing 
Computing. 

So to get all this wonderful 
information, call 1-800-345-3360 today 
and talk to a friendly Customer 
Service Represents ve about getting 
your GUIDE, Or, stop by your local 
dealer and demand your copy of the 
latest AC 's GUIDE for the 
Co m m odo re A m iga , 

Coming Soon: Winter 
y 1992 Edition! j 



List of Advertisers 



Company 



Pg, RS Number 



Amos Cll 103 

Delphi Noetic 1 1 

J & C Computer Services 26 101 

Memory Management 53 102 

True BASIC ,lnc. 78 106 

SAS Institute CIV 105 

'Delphi Noetic asks that you contact them directly. 
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A few notes before you dive into the disk! 



1 You need a working knowledge of the AmigaDOS CIJ as most oJ the files on the 
AG's TECH disk are only accessible from the CI 1 

In order to fit as much i nt brmation as p< i ■ \ TECH Disk, we arcnj ved 

many of the files, using the freel) redistributable archive unlus lluix' i « h»ch is 
Jed in the C: directory), lharc archive files have the filename extension J/h. 

To unarchi ve j fi Ic foo. I:h, t •. . fao 

For help wilh lhare. type Una 

• i/« h'j/a "tod " icons am be umrchivedfrom ihe WorkBench by double clt m, and supplying a path. 




We pride ourselves In the «^ *aii*Y of ou? per"* 
ond magrHj'-c media pubic ^ ou* However, n 
th# « nyhty " mlik. of a fayfly u' rfcjv^- 

age^ " wiuifi She disk to PfM 

r jo*cor»or'; jirrc. Tos u free reptocornenr 
P»»?^*o retu^i the «*** to, 

AC* rprw 

Dw ^placement 

■ 



fie Sure to 
Make a 
Backup! 



Due la ihe leitm* »l and enpefiitiroul ruiurr ol Haw of 
the program ua the AC \ II -( H |>a. »r iMi ihc 
n •' r: t-Hcowkpn ctpcdaMyiilnittiiHapcMiHid 
ptOfnuiM da inmate toM-ltWl he emirr 

Ikiexluji of We ijiialll} Mid Jiniiwmjnh r i.J ihc wftaun Ml 

IfceAC ^wunrd.^ wwjuir^ 

hibhcabaM. inc, their «lucnhuu*v a is™ rruilcrv » itl 
nc* be ti*hlc rot my dieeo. indatccj, c* cimrnniniUtJ 
llmp> rewhmi (torn ihe uv a mmw of ihc u ilinwr 
iwiftev <Hn» nt wm cM ttny nut «pp«> 

in afTiaofnphicil art** i 
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ihe AC* T8CM Ihvk j«r f.(rt> rrdiUnbuUMc . the AC i 

1 1 c H th ift nsrlf and itetmllwuwio* nditidual (ilnml 

i 8 Cll Oni trr rcppifhl C I »M, 

v Inc. and na> arthedUratcaied 

"i*« W) lVfx"vhj»tiln™rvcTi»encouf»|»J|ijiiuLf 

HichtB> «*J o* (he AC"i TECH IXii 

\Ui. hcciurm 

">d an) daaiaee 

ifui CM ( (MM thai irung lira prapvli 

..! ihc wjnunlK-t O* jwa computer eqiMjmeat 

-. amm», it w) tifn'i tftMx. n not mpa i i lMi 

f>K jaii daflUfn IK Mnd wMt ■tlemptin* chit project 
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Programming the Amiga in 
Assembly Language 



In William l\ Nee 



USING LHARC 

Always on the lookout for an easier way to do things, I 
want to show you a new way to load the files you roe 
assembly language programming into RAM. I put LI IAR< 
located on the magazine disk, in die C directory and then used 
it to create two 1 1 les ( ontalning: 



C/CFILESLZH 
A68K BLINK 
CD COPY 
DELETE D1R 
ED MAKEDIR 

MORI 



i\t u nisi v\ i 

EXECMACROS.i 

DOSMA< 

IMMACROSi 

GFXMACROSd 

ask \x:on i>- 



Then I modified my Si a rtup -Sequence to include. 

COPYCFJI IM/IIRAMC 

COPY INK I I I >l s.l /I I RAM: 

COPY C/LHARC RAMC 

CD RAM:C 

I I lARCXCFIt.l s.l /I I 

DELETE CFJLES.LZH 

CD RAM: 

RAM:C/LHARC X INCLUDES.LZH 

DELETE QMC I UDES.l ZM 

This method does use a lot of memory since you have both 
the packed and unpacked files in RAM for a while. If you're 
running low on memory.. Include le^s m the I /I I files, or try 
deleting each packed file individually al unpack it, 

instead of deli tile when all of the individual 

files are unpacked. I've also included NoClick3.4 r an excellent 
program thai stops the drives from clicking all the time. You 
might wan! to include it in your Startup Sequence. 

WALLPAPER 

In this article I'll discuss double-buffering (using multiple 
screens to swap images), running assembly language programs 
from Basic, and passing values to a program. I'll start with 
double-but ifering first and use a program called WALLPAPER 
to demonstrate it ftus program sets cells in a 160X160 array to 
various values. During the second pass the values of the four 
neighbors around a cell are added together and ANJX-d v 
this becomes tin new cell value for array2. When new cell 
values have been computed tor the entire array!, |lv 
transferred lo array 1 and shown on the screen. 



Without a--', further modification, running the program 
this way would show a noticeable ripple effect But, with 
multiple screens, we can show one screen 
points on the second reen, and display itj thencomput 
place new points un the first screen and display it. Keep 
alternating between st reens until the LVII3 i Lett Mouse Button] 
is pressed. 

To set up multiple screens we need to open two screens and 
two wind ;. also need the bitplane addresses froa 

window since I'll be using tin macro from the previous 

article of this series. The 3 louble-bufJ the Intu- 

ition command Screen I o! Font. I Ving this command we can 
show one screen (bri differenl 

RastPort to draw on a differenl screen: then bring thai -. 
to the front and use the other RastPort to draw. Keep looping 
in this i imple usingSCREENI, RP1, 

I \2, and RP2 is; 

LOOP 

USE RP1 

SCREEN2 TO FRONT 
PCI 
DRAW 
USERF2 

SCREEN 1 TO FRONT 
PC i 

DRAW 
BRANCH TO LOOP 

Now let's look al Listing 1. The two INCLUDE riles will 
handle the Exec and Graphics macros. Since the Intuition 
macros are so different because of double-buffering, it's e 
to include part d the listing. The program first opens 

SCREEN 1 and SCREEN2, and then opens i ows. The 

main difference between the two windows is that WINDOW1 
is set to be active (ACTIVATE) when it is opened. 

Alter each window is opened, its RastPon is obta 
id then used to bitplane locations. The 

bitplanes are only accurate according to the DEFT1 1 
set at the beginning of the progra the ARRAY macro 

will clear two arrays to zero; then size Is again defined at tin 
ot the program as SIZE. There are rwp Demos tor you lo 
use; the first draws i 

The i of the progra v the double-buffering 

routine- - is brought to the i ; tile 

RastPbrti Is used as Hie current RasfFH 1 clearing 
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PART IV - A Return To B 



asic 



SCREF.X2, new array values are computed and drawn on 
SCREE N2 using HwQFSET macro Then SCREEN2 is brought 
(0 (he (mm displaying it, and RastPortl is assigned as the 
current RastPort. St KEEN I Is cleared, new array values .ire 
computed, and then drawn on it, A check is made to see 
pressed the LMB and, it not, the entire process repeals. 
When you do press the LMB, the memory in both ai 
treed, both windows ,m,l then both screens are closed, and the 
Graphics and Intuition libraries are closed In the dal 

can see that I reserved spat e for I he screens, window 
RP1 , RP2, and an RP Bv moving the current RP1 or RP2 b 
I was able to use all the macros that call for RP, Save this 
program as WALLPAPER. ASM ,uui .issombfe and BLINK it as 
WALLPAPER — or copy it from the magazine disk. If you don't 
have them from Part III of this series, the two INICLL I 
files are also on the magazine disk. I've made a tew chang 
theGFXMACROS.i. Try changing this program bv Increasing 



me language program store the color value of all 
set points in an array jusl like Basic's POINT command. In fact, 
I call the n isig ReadPbceJ POINT. 

The arrays .ire 1 60X1 61 I SO I used 26000 as the SIZE in the 
ARRAY macro. Another new macro is PUSHALL which saves 
all eight data n ilong with the ftrsl seven address 

registers and ii values jusl Mow the Stack Pointer 

(a7). MOVEM means to c . tiple registers; me "-" means 

through and "/"roe So we'll move multiple registers 

dO through d7and also aO through a6 to tin- memory location 
Starting four K tes below the Stack Pointer. The macro 
I 'i. LI M 1 reverses the procedure, returning the original value 
of all the registers The onh other new macro, as I mentioned, 
'INT which uses the ReadPixel routine to return the color 
•••■ ery point on the screen w ilhin the ana) , Since Basic 
considers the bonier w her seW point and FA5TPFXEL 
doesn't, any point you dl i iff in the i 



To set up multiple m rtins \\v miil lo open ivmi screens and Iwu uiinlcn**. We'll 

also need the hitplane addresses for eaeli window since we'll be using the 

QPSET macro from the previous article of this series. 



the DEPTH value and then ANDing the rvighborhood SUM 
with a different value, 

FROM BASIC 

: values to and running . 
machine language program from Basic. The general ide.i is to 
convert the assembled program into a new file of data lilies 
that are the actual number values (0-255) of each instruction, 
This tile is then merged with your Basic program, and each 
data line is RI ; Al> and stored in a variable array. The machine 
language program is executed with a CALL to the beginning 
location of the array. I'll go over this W ith VOU Step-b) -sh 
we develop the program- 

look at the assembly language portion. Listing 2 first, 
The program is a lot smaller since we're us I up 

the screen and window. There is i me new graphics routine, 
ReadPixel which will read the CoJoi I alue of any point on the 
screen a nd retu rn tha t va I ue i n regi stei , v you 

to draw a picture on the screen or set any points, and then 



direction and two off in the down direction. That's why POINT 
only adds 76 to a< ross instead of the usual 80 to center the 
j , and only adds 18 instead o4 

The ARRAY macro uses ( I EAR and PUBLIC men. 

e not sure where the memory will be found now that 
we're running every thir PUBLIC lets the com- 

puter choose PAST memory if available or CHIP memory as an 
alternative. Since the memory is used only to store data, we 
don't care where it . gned, This array uses the rules for 

t h e ga me ol fitter game whe re there are no w inners 

rt, a cell in the array is etther alive (set to 1) 
m dead (set to ii), During the first generation the neighborhood 
I alue ol the ei^ht cells around a center cell is computed, 11 the 
original cell is alive and has only two or three neighbors, it wilJ 
live to the next dead but has three neighbors, 

the ne\t geiH'r.i i ion. Any other case 
results in .i dead cell We'll examine these rules more closely 

Liter. 
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let's review Ihe entire machine language program. In 
pro mil-, .irti, les iwe go! Ihe bitplane addresses bj using the 
RastPort address within Ihe window structure. But now we've 
let Bask" open the window, sh* n here is the window structure 
or the RastPort? In Basic, the window structure is returned 
witii WI\IX>W(7)and since il is used so often, the I 
W l\|)OW(8). This location will be passed from Basic when we 
call the machine language program, When only one variable is 
passed, its value is in register d? al the start of the program. 
Before you did anything else poll ivould store this value in Kl' 
and get the bitplanes in the usual manner. 

PASSING VARIABLES 

I said that I'd show you how to pass multiple variables 
from Basic to your machine language program. Using the 
PUSHALL macro I described, vi ell move 1 5 Sow listers 

below the Stack Pointer i filling bytes 0-63. Am 

variables you pass with your call start at the next lot 
(byte64) and will be four bytes long. So if you pass variables A, 
B and C within your call, variable A=64(a7), B=68(a7), and 
a7). These locations car; whenever you want 

within a program Since they won't change. The assembler I'm 
using, A68K, usually requires you to move a variable to a 
labeled location before you use it, tf vour call passed three 
variables named RP, ACROSS and I X1WN, you would 
probably save them as: 

MOVEL 64(A7),RP 
MOVE.L 72(A7),LX)WN 
MOVE L 68{ A7), AC ROSS 

The first variable, as 1 said, is also initially stored in register 
d7. 

Next, the Graphics library is opened. Since Basic may store 
our assembled program anywhere, the location called "gfx" 
may always be different. But we can't re-assemble the program 
each time we run it, so we must use what is called "position 
independent code." The Position Counter (PC) is another 
register that keeps track of the add ress ol each line being 

ited so a line like GFX(PC) is just an offset. When this line 
embled it will resemble a branch and will always store 
the address a certain number of bytes away from the current 
address in al if storing the original address of "gfx". 

This will generate accurate code HO matter where Basic stores 
the library names. 

Next, the program reads each point on Ihe screen within 
the array and stores that value in arrav 1 1 1n t.i kes a few 
seconds to do. To compute the neighborhood of a cell, I said 
that we added up the val eight cells around it. Most of 

the eel larly generation of life have a zero va 1 1 

adding up eight zeros just to get zero wastes a lot of time. 
Another method that works much more quickly is to add the 
current value of a cell to the eight corresponding neighbor cells 
in the second array. That way you only stop for cells thai h.u e 
a value and skip over any d e At the end of the fil 

pass, array2 will contain the value of each neighborhood for 
the corresponding cell in array] . This routine would look like: 

TST.B (A4) 
BEQ.S CONTINUE 



ADDQ.B »1,-162(A5) jtop-left neighbor 
ADDQ.B *1,-161(A5) jtop neighbor 
ADDQ.B *L-160<A5) ,1op-right neighbor 
ADDQ.B #l,-l(A5) ;left neighbor 
etc. 

RULES OF LIFE 

Let's look at the rules again for the next generation. 
restating them and using .in OR table to show the results. 

CURRENT NEIGHBORHOOD NEW OR TABLE 

1 0OR3-3 

1 2 1 !OR2=3 
l i 1 IOR3-3 

The only cases that produce a new cell are when the old i 
value OR'd with the neighborhood value results in 3, Any 
other result will create a dead cell. This will give us jusfl one 
comparison instead of three, 

I also wanted my version of Life to wrap-around. In this 
way, a shape going off the right side will reappear on the left; a 
shape going off the bottom will reappear at the top. We'll still 
use our 160X160 array. The inside squaiv starting al (1,H, the 
center square, uses the same routine as Listing 1 Any location 
within an array is (length* I )*down+ across. That's why (1,1) or 
( 160+1 )*1+1 is the 162nd element within the array. 

WRAP-AROUND 

There are two wa) s to approach programming a wrap- 
around function II we limit the array size to multiple!! of 2-1 
(i.e., 31,63, 255), any cell location AND the length will always 
wrap back. In a 63X63 array, the cell to the right of .in edge 
would be (63 I 1 1 USID 63 or the Q cell in that row; the cell 
above a top cell would be (0-1) AND 63 or the 63rd cell in that 
column. But this does restrict the size of the array and, as a 
minimum, the cells on the outside rows And columns must 
always have the extra A\l I which slows down the program a 

little 

1 decided to actually compute and check the eight square-. 
around the four corners, the top row, the bottom row, and the 
sides, Rather than repeated]] iddq.b rtT" we'll let the 

INCREASE macro do that and just pass the location of the 
eight cells within array 2 that get increased. Starting with the 
cell in the upper- left cor u ighbor is one cell to the 

left, which wraps to the right oJ the first row, and one up, 
which wraps to the bottom of the last column—the lower-right 

rr. That location is 161*160+160 or 160*162 and that's the 
first value passed in the "increase" macro. The next neighbor is 
one above which wraps to the bottom of the first * olunui or 
160*161+0. All eight neighbors are computed in this manner. 

The next corner is 160 away, and if its alive, compute its 
eight neighbors and increase each of them in array! The 
lower-left corner is 161*160 cells away. 90 ch« k it and, if 
necessary, its eight neighbors. Finally, the lower-right corner is 
162*160 cells away. Notice that we never had to change the 
location in registers A 4 and A5. They remained constant while 
we kept looking at and increasing locations a fixed distance 
from them. 

To get the neighbors for the top row, however, it will be 
easier to increase our locations within the arrays by 1 after each 
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check, The top rou I jO) and is 159 bytes long (1-159), 

The DBF counter is gel to 158 Since il goes down to I). When- 
possible, use tht- postincrement mode to increase b 
!i rather than LEA, Alter the neighbors for the top row 
Are compu ted i nged to (1,161 

I combined the left and right side since an increase oi l 
;htsidetakesi i the left side Alter all the 

cells tin the Sides have been chi-cked and their neighbors in 
array! Increased, the program looks at all the cells within the 
center square. This is our familiar procedure from previous 
where we start at location (1,1) in both arrays. 

When the entire array has been checked, array2 contains 
the sum of the neighbors around each corresponding cell in 
array I. Store that value in "sum and then clear arravZ. Now 
we need to OR this value with the original cell, so more the 
contents of array! in dl then OR dl with "sum". Il the result is 
not 3 the new cell is store a in "sum". But if the 

value is 3 the new cell is alive regardless of its previ 
so store a 1 in "sum". Compare the new value of sum to the 
old value in array I- Il they re the same we can go to the next 
location. If they're different, however, we must change the 
value in array! and reset the point on the sen 

1 is Mi', i urrenl value, store that in array 1 for the 
new cell value. The FASTFIXEL routine is slightly different 
from previous ones since then- is on!) onebitplane and there is 
no need for a loop through the planes, Once the location th.it 
must be changed is computed we can change it with just one 
wind, Because it can only be or 1 and must be changed, 
use the it HG (DM CHanGe) command to change, or reverse, 
one bit, Then the array I address is increased by 1, all the I 
the values in array2 compared to arrayl, and the m , essary bits 

•ii press the I MH. the program branches 
back to the beginning. 

DATA LINES 

Save this pi kS 1 Iff ASM then assemble and BLINK 

as LIFE, or copy it from the magazine disk. Now we have to 
transfer theassembi ram into a fiJeol numbers that can 

be made into DATA lines, t isting 3 is a Basic program that 
I isting 3 as DATA and run it from Basic, or 
even better, transfei tins program and AmigaBasic to RAM 
and run it bom there. At the prompt, enter the program name 
I l M \ new ASCII file called UFE.DAT will be created 
consisting oJ data lines with eight numbers per line; the last 
number "999" is added to indicate the end of data. 

Now type in I isting 4 and then MERGE "LIFE, DAT"; • 
this program as LIFE. BAS,a— or copy it from the magazine 
disk. The program uses P() to hold the data value and assigns 
values to PROGRAM and V Al I I Bj doing this at the 
beginning, Basic will assign them an immediate location and 
not move them around later. RP& is the RastPort and PRO- 
GRAM is the beginning of the array holding the machine 
language data Tin demos to use; the R-pentano 

will increase for WOO generations before it stabilizes. Notice 
that it produces little objects called "gliders" that slowly move 
across t he *.. ren iders will always live unless they 

bump into something. The collision of two gliders can produce 
someinte 
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C»cMt 103 on R*od*< Stntc* cad 

As I mentioned, A68K adds some extra code at the begin- 
ning and end of its assembled program. To see where the 
program starts, Imik tor the code of the PUSHALL macro (72, 
231, 255, 245). i his is usually around line 4 of the DATA lines, 
Wherever il is, though, all code before il can be deleted- If you 
put in a few MOP'S at the end of the program, then the code of 
78,113 will stand out and you can eliminate everything .liter 
them except for the "999". This won't make the program run 
any differently, but it does cut down on the number of DATA 

ml the size ol the array you need to hold them. Now, 
whenever you use the Bask LIFE program, the machine 
Language code is already there for you. Notice that there is no 
CAL1 lomm-ind, just the name of ihi- arrav and the value to be 

I rhJs is an a I terna five way of using the C A LL com- 
mand. 

NEXT TIME 

In i hi- next article I'll discuss menus an ii 
machine language and well use double- precision floating- 
point numbers to draw the Mandelbrot Set. If you have any 
questions about these artii lies or ideas for future ones, you may 
write to me in care of this magazine, 



Listing One 



ww. screen 

WW. IT 



S2e 
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opens r 

openwindow ■ -204 
closescrt-v 

scre< - -252 

. 

a6l 
endn 

openscreen macro 
lea U.aG 

operu 
d0,\2 
endn 
openwindow macro 
lea U.aO 

2,nw.-creen(a0) 
openwindow 
move.l dQ,\i 



start : 

move.! sp, stack 

openlib gfx.donei ;oj 

set_up 

openscreen rcysereenl , screenl 
openscreen myscreen2 , screen! 



•save stack po 

x*n all th* 



openwindow mywindowl , screen 1 , w i ndowl 


move.l 


dO.aO 


movea. 1 


ww.rport <aQ) ,al 


move,* 




movea . 1 


. . 


lea 




cnove.l 


& i al I , 


move . . 


12 (al), 



24<al>,CaO> 

openwindow myvindow2 , screen2 , wi ndow2 
movea. 1 dl 

• . 
a 1 . rp2 
movea,! 4 (a; 
Lea bp2,a0 

move.l 8(alj , <a0) * 
move.l 12 (a 
move. I 16(al>, [a0»* 
cnove.l 20 (i 
move. . 

memory 

array art ■ 

array array 2 , donel 

bra . e demo2 

demo - : 



no '-''Xj 



movea. i 


i . , 




4910.; i 


ove,b 


•1. 


lea 




move.b 


11,0(3%) 






addq.w 


rosa 


". .w 


•101 .across 


-".''_;! 


dla 




loopl 


deno2; 




moveq 


•0, across 


m vu . ; 




lea 


8100(a3).a3 


movea. 1 


1 ,a4 


lea 


• 4).a4 


•~> .'•- i . . 






eiooc,i 




yl.afi 


1 ■ I 


17760 U6J ,a6 


moveq 


•0, across 


d2a mave.b 


*l,Q<a3> 


lea 




1 M 






a5r 


lea 








lea 




add i.w 


•1, across 


cnp.w 


•61. across 


bne.a 


d2e 


moveq 


#0, across 


moveq 


•Q,d' 


; double buffering 


loopl 




movea. ] 


screenl , aO 


intllb 


screento front 


movea. ; 


rp2 , aO 


move. , 


aO.rp 


pels 












movea . 1 


screen2,a0 




■nto front 


m /ea,l 


rpl.aO 


move.l 


aO,rp 


pels 




lea.l 




bsr 




r-'; j]'": ; : 




lata 


loopl 


bra 














t4» ,a4 


movea. 1 


v2,a5 


.<• i 
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• 


•0, SUP 


irove , b 


-161 <a4) ,sucn 


add.b 








add.b 


• 


andi.b 




nv. 


Hum. <a5> ♦ 




• ' ,a4 




acre 










dbf 


dawn, r2 


moves, i 




movca . 1 


arra 





• sum 






QjOfigt 




lea 




lea 




next one 




id 1 ;,v,- 




anp , w 




bne.s 




addq.w 


11 .dour. 


arp.w 






rl 


done 1 : 




tree 









inovu 


.1 windowl. a0 




b cl 




--. .•- j 


• 








movea 


. 




intlib 


osescreen. 


. • : .': 






close 


lib 


gfx 




lib 




n '■,'• i 


1 




rta 






evenpt 




stack 


del 





gl Kba m 


del 





intbaee 


del 





screeni 






screeni 


dc * 1 





windowl 


dc.l 





windows 


dc,l 





rp 


dc.l 




rpl 




D 


rp2 




D 


arrayl 


dc.l 


D 


array2 


dc.l 





bpl ds 






bp2 ds 


. 











evenpc 

int dc.b * intuition., library' .0 

evenpc 
my screeni 

.0,320,200, : 

dew 

evenpc 
uyscreenl 

dc.w 0, .'.depth 
dc,b 0,1 
dc.w 0,Sf 
dc.l 0,0,0,0 
evenpc 
low! 

.320,200 





] 






dc.w Sf 




• wipe 






0,0,320,200 


dc.b 


0.1 







•J. . . 




dc.l 


0,0 


. 




dc.l 





dc.w 




end 









All the source code and executable 

file** for Programming the Amiga in 

Assembly Language can be found on 

the ACl TECH Disk. 



PI ease write in: 

William INer 

c/o \i\ TECH 

P.O. Box 2140 

Fail River, HA 02722-21 Ml 
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TWO EVENTS SPURRED MY INTEREST in 
Mandelbrot sets. For several years 1 had been vaguely aw are ol 
a recently -discovered branch of mathematics known as 
"fractals", which require so many computations that they can 
only be calculated with a computer, and I knew a Mandelbrot 
set was a specific kind ol fractal. 

However, smashing into engineering math in college 
(and eventually emerging with a computer science, not 
engineering, degree) left me with a distaste for high-level 
mathematics. I was also turned off by the computation- 
intensive nature of the field. Between 1989 and 1991, Amazing 

pitting published a six-parl series on (facials by Paul 
Castonguay. The articles were interesting, but it appeared that 
a typical fractal would require four or five hours to generate. 
With the Amiga's multitasking, the calculation^ amid be run 
in the background, but it would slow the system down and my 
software development efforts typically resulted In several 
system crashes in that amount of time. 

Then I bought a 25 MHz. Amiga 3000 and read The 
Ghost From The Grand Banks by Arthur C Clarke. The novel 
describes two corporations in 2012 racing to raise the 
Titanic for the 100th anniversary of her sinking. A major 
subplot is Ihe Mandelbrot set obsession shared by several of 
the charat ',< 

"Mandi'hrumus". .is i Lirke calls it, takes several forms 
in Ghost, from a grief-stricken mother spending months 
searching a supercomputer-generated section of a set with a 

mage larger than the galaxy for a lost child, to the 
construction, with tragi of a Mandelbrot set-shaped 
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00:28:26 Max : *8 . 688800 , +8 . 975060 508 




JimOdnget 



Figure One: The base Mandelbrot set. 
Page 57: Top, Figure 2A. Bottom, Figure 2B. 
Each image is a zoom" of the previous image. 
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pond on the grounds of an Irish castle. Clarke 
himsell doesn't appear to be immune. Some of 
his descriptions of Mandelbrot sets have a 
poetic quality I've never seen in his other work: 

"The image expanded. It was like 
watching a zip-fastener being pulled open - 
except that the teeth of the zipper had the most 
extraordinary shapes. First they looked like 
baby elephants, waving tiny trunks. Then the 
trunks became tentacles. Then the tentacles 
sprouted eyes, which opened up into black 
whirlpools, of infinite depth." 

"They swept past the whirlpools, 
skirting mysterious islands guarded bv reels ol 
coral, flotillas of seahorses sailed by in stately 
procession. At the screen's exact center, a ttnv 
black dot appeared, expanded - and revealed 
itself as an exact replica of the original set. Or 
was it?" 

Suddenly, J wanted to get Ln there and 
do some exploring of my own. My shiny new 
A3000 isn't quite a Connection Machine, but it 
has a fa| more computing horsepower then Benoit Mandelbrot 
had when he started his work on fractals in the 1970s. So, I dug 
through my back issues of Amazing Computing for Paul 
nguay's articles and started programming. 

Thirty Seconds Over Lake Mandelbrot 

A detailed explanation of the mathematical theory 
behind Mandelbrot sets is beyond the scope of this author. For 
more technical information, I strongly recommend Paul 
Castonguay's Amazing Computing articles and Chapters 1 3, 
20 and the appendixes ot TjuiLLh ost From The Grand Banks. 
where Clarke men I Amiga 2000 he used in his 

Mandelbrot sel research (He now has an Amiga 3000). In case 
you don't have these resources available, I will briefly discuss 
a few bask Mandelbrot set c on c ep ts, 



HSet7 M in: -8 .680880, +0. 682528 Crunch 
00:12:08 Max : + 9. 100808, +1 . 1 97528 566 





The Mandelbrot set is based on an ite i <ess. 

The Mandelbrot equation is solved for an initial value. Then, 
the output of the equation is fed back into its input and the 
equation is recalculated until its output either rapidly increases 
toward infinity ("blows up") or starts producing a single value 
or a small range of values ("converges"). 

The Mandelbrot "equation" is actually two equations; 
"Xnew = X * X - y * y + i" and " Ynew b J • x • y + j", Ihese are 

■mely simple, using ijtion, subtraction and 

multiplication. Most mathematically knowledgeable people 
who haven't been exposed to fractals would guess that the 
equations would produce some sort of oval. Anything truly 
complex should require higher mathematics, such as loga- 
rithms or trigonometric functions. No one, not even Benoit 
Mandelbrot when he started his research, could imagine the 
complexity hidden within those simple 
equation - 

A mathematical set is a list ot solutions to an 
equation. The Mandelbrot set is the boundary 
between the numbers on an X-Y plane thai 
blow up and those that converge. 

The limits of the Mandelbrot set ate -2.0 to 
+0.8 in the X direction and -1 .2 to + 1 .2 in the Y 
direction This is called the "base set". Any 
values outside this range will quickly blow 
The lower X limit of the default "base sel 
the program presented in this article is -2.4. 
This reveals the complete tack of features to the 
left of -2.0 and shows the detailed structures at 
the top and bottom of the screen, 

The values used in Mandelbrot sel calcula- 
tions are pure numbers. They do not represent 
any kind of physical quantities. I lowever, 
physical terms are used for convenier 
Compass directions describe relative positions 
within the sel. For example, an X value of -2.0 is 
"Utter West". This is the edge ol the 
Mandelbrot universe and nothing exists 
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MSet? Min:-e. 214438, +8.991469 Crunch 
99:83:32 Max : -ft . 1 09625, +1 . 679978 599 




beyond this point. The large areas ol t out ergence are often 
called "oceans" or "bikes'" ind the smallei areas around then 
are "bays", Areas leading lo the bays resemble "deltas" 
although, unlike geographical river deltas, they do not contain 
"rivers" of convergence. 

Relative size cart be used to describe the amount of 
magnification. On my monitor, the base set (X = -2.0 to +0.8, Y 
s -1.2 to +1.2) is about 9.5 inches wide. A small zoom (X - -0 IK 
to -0.14, Y = +1 .02 to +1,04) results in a base width of 63 feet. 
Serious Mandelbrot explorers often use expansions which 
would fill the orbit ol Matsl 

To produce a graphic image of a Mandelbrot set, 
maximum and minimum coordinates are specified. These 
limits are divided by the computer screen resolution to 
produce a set of discrete X and Y values, Each of these points is 
fed into the iterative equation, whkh 
or converges. The result is then plotted on the 
computer screen. 

The resulting images are impressive In 
black and white, but adding color can trans- 
form them into objects of amazing beauty. The 
trick is to assign colors based on the numb' 
iterations required to determine if the point is 
inside or outside the Mandelbrot set. This 
produces a plot like a contour map, where 
d 1 1' ft' renew in elevati i presented by 

different colors. 

Into the Depths 

The primary controls tor "MSet", the 
program accompanying this article, are the 
minimum and maximum X-Y coordinates, the 
blow-up limit, and the convergence limit. The 
X-Y coordinates determine ' I and 



Top, Figure 2C. Right, Figure 2D. 



magnification of the set to be calculated If the 
output of the equation exceeds the blow-up 
limit ("max", which is set to 4.0 in MSet), it is 
safe to assume thai the output is increasing 
toward infinity. The number of iterations 
before the blow-up limit is reached is usually 
called "depth". The convergence limit 
("crunch") is more arbitrary. It is the number of 
Iterations after which the equation is assumed 
10 1 1, i ve converged. 

Some Mandelbrot set programs boast 
blazing speed by using an unrealistu .ilk Km 
crunch value, such as 30. For extremely low 
magnifications, this can produce acceptable 
results, As the X-Y range is decreased, the 
equation tends to blow up more slowly, so a 
low crunch value will produce many false 
convergence indications. 

The "AnalyzeRangeO" procedure in MSet 
i he distribution of blow-up values Pen 
the base set (X = -2,0 to +0.8, Y - -13 to +1 .2), 
most all blow-ups occur within 30 iterations. 

For a relativel) small zoom (X - -0.168 to -0.152, Y = +1.028 to 

+1.040), 59 percent of the blow-ups occur between 30 and #99 

iterations. 

The default crunch value of 500 is a reasonable 

compromise between speed and accuracy. For high magnifk i 

turns, larger * rum h hould be selected. 

The Base "MSet" 

The program "MSet" is written in Benchmark 
Modula-2. It consists ol several modules, with each module 
implementing a set of related functions. Before examining the 
individual modules, let's discuss a few overall concepts. 

The only display mode MSet supports is low re 
tion (.120 X 2(H)). This pro\ Ides the maximum number of colors 
1 32 ). eliminates die complication of writing code to support 
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multiple resolutions, calculates a specific set in minimum time, 
and minimizes the amount of memory and disk space required 
to store depth information, 

The accuracy of the program is limited, because REAL 
numbers are used for all the calculations, REAL numbers use 
the Motorola Fast Floating Point format, which only gives nine 
digits of precision, lfi.it isn't too good for serious Mandelbrot 
set exploration, which often uses hundred-digit numbers. The 
Benchmark "System" module contains procedures for opera- 
huns on LONGREAL numbers, which offer 36 digits ol 
precision, but the Benchmark manual warns that the "System*' 
procedures ,m i.i internal use only, It's true, It 
these procedures, or even attempt to perform an operation on a 
LONGREAL, the computer will crash 

It would be possible, but messy, to rewrite MSet to 
use two REAL numbers to represent each coordinate. A 
different language could be used; both C and BASIC support 
double-precision floating point numbers. Since I prefer 
Modula-2, tfu" ideal solution would be to discover how to use 
LONGREAL numbers with Benchmark. If anyone has found a 
way to do this, I'd really like to hear about 1 1 



These times were obtained by running the programs 
on a stock Amiga 1000. When 1 ran the same MSet variatM 
my 25 MHz Amiga 3000, the computation time dropped to 28 
minutes, a speed increase of about 4.5. 1 actually expected a 
greater speed increase. The difference in clock speed atone 
should decrease calculation time by a factor of 3.5. Does the 
Modula-2 floating point library actually use the A3000's 68882 
numeric coprocessor? If not, how do you access the 68882? 

Zooming In 

The "MSet Data" module contains the control vari- 
ables and constants needed by the other modules, In the 
"MSetDepth" module, the depth of each point is stored in a 
I )INAL variable. This gives a maximum depth of 65535 
and uses two bytes per point. The depth information for a low- 
reso lu Hon {320X2CX p proxima tely 1 28K of 

memory. In Benchmark Modula-2 the maximum size of an 
fliray is 32K. In fact, 32K is the maximum space allowed for ail 
variables in a single module or procedure, 



If the proportions of the set's X and Y limits don't match 
the computer screen, the display will be distorted. 



Mandelbrot sets are transformed from mathematics 
phenomena to objects of art by using colors to represent the 
depth i>l each point. "Depth" is the number of iterations 
required to determine if a point is inside or outside the set. 
When depth calculations for a single set require hours, even on 
an accelerated Amiga, ii becomes very desirable to avoid 
recalculating the same set. Depth data is stored in the 
"MSetDepth" module. 

The main artistic controls over a specific Mandelbrot 
set are the color registers assigned to specific depth values 
("color selection") and the actual RGB values for each color 
register ("palette"). MSet has been written to give maximum 
control over these parameters without requiring any additional 
miming. 

In bis first A maz ing G i mp utii ig a rticle, Paul 
•nguay lists the speeds of several \ ersions of a 
Mandelbrot set program. The Lattice C program took 4 1 
42 minutes to calculate the set, using the standard IEEE 
floating point library. Using the less accurate fast floating point 
library reduced the time to 2 hours, 27 minutes. 

Aversion ol MSet calculated the same set in 2 hours, 
12 minutes. Since MSet uses a slightly different algorithm from 
the C program, the times cant be compared directly, It's 
say there is no significant difference in execution speed 
between C and Modula-2 programs for this type of computa- 
tion. The floating point library is the most important factor in 
determining Mandelbrot set calculation Speed 



Dynamic memory allocation to the rescue! Memory 
obtained using the " AllocMemQ" procedure does not occupy 
variable space and is not subject to the 32K limit. MSetDepth 
tins procedures for allocating and releasing the memory 
where depth information will be stored, as well as storing and 
retrieving the depth of a single point. The module can also 
save and read the depth data from disk, 

Most of the Amiga-specific code is in 
"MSetResources". This module allocates and releases system 
irees (display screen, window and depth storage), clears 
the screen, plots points, displays the set lirnlta al the top ol the 
screen, draws a box showing newly-selected limits, sets color 
register RGB values, and performs a few utility functions. 

Isolating machine-- - p ■ - .in.: code in i single module is a 
good technique for writing programs which can be easi Im- 
ported to another system. It also reduces the possibility of side 
effects. MSetReaoun es is the only module with access to 
sensitive system data structures, such as the screen and 

dow pointers. No other module can accidentally modify 
system data. 

The color selection and palette procedures are in 
"MSetColors". "AddColorO" is used to build a linked list of 
color range records. Each range record contains tow and high 
depth values and a color register number. The "OolorQ" 
procedure scans the list for a depth range matching the input 
depth and returns the appropriate color register number. If no 
match is found, the highest cotoi register number (31) is 
returned. "ReleaseColorsQ" i memory used b) the 
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<-». 163169, +1 ,826267) 





Top to bottom: Figures 2E-2G. Each zoom reveals 
more intricate detail and fascinating patterns. 



current color range list. It is used before a new color selection 
Hst is entered and al program termm.it ion 

MSetColors contains three procedures which 
color selection lists. These can be used as models for your own 
color selection algorithms. "AOColorsSetLpO" is a 32-cotor 
version of the 1 6-color selection method in Paul Ostonguay's 
third Mandelbrot sel article. This gives good results for a wide 

J of sets and is the program's default color select ion 
methi 

I devised the other two algorithms in MSetColois. 
"EqualPointsColorsSetL pi ; > .! istributes the color selection so 
that each color is assigned to an equal number of points. When 
a large number of points have the same de| igle color is 

assigned to that depth. Otherwise, one color is assigned to a 
narrow range of depths This selection method must be run 
alter B new set is calculated or after the depth data of an old set 
is loaded from disk. It always produces a good-looking 
'lay. 

ui^eColorsSetUpO" divides depth values 
from to crunch into equal color ranges This is a very logical 
and mathematically pre* ise color selection method which 
produces a boring and almost useless display. I left it in the 
program to show the limits of using logic and strict mathemati- 
cal relationships when exploring, Mandelbrot sets, Intuition, 
inspiration and experimentation will take you much further, 

There are two procedures to set sample palettes in 
MSetColors. "SclRatnbowPaletteij" offers 1 I colors, with each 
color having several intensity levels Except for black, the 
colors arc arranged so that brightness increases with depth, 
I he specific colors were chosen for pure!) aesthetic reasons. 
Displays which use this palette tend to have a brilliant, jewel- 
like quality, 

is in "SetDepthPalettei rare arranged so 
brightness decreases as deptl F his produces a 

display a little like a contour map of the ocean Moor, where 
deeper blues indicate deeper water. The "depth " palette still 

multiple colors. Since a standard taniga only has 16 levels 
( fou r bi Is ) of red , g reen and bl val ues, it • i hie to 

get 32 shades of a single color, li w e restrit I the display to 16 
colors, it's difficult to see the difference between adjacent 
values. Sigh! I wish Commodore would hurry up and increase 
the number of standard Amiga colors. 

The "MSetAnalwe" module contains two depth 
analysis procedures. "AnalyzeDeplhQ" displays the number of 
occurrences of each depth value, sotted from most to le.i-.r 
occurrences. It uses a "comb" sort from tin April 1991 issue of 
Byte. By a happy coincidence, this algorithm was developed on 
an Amiga 2000. Il can help you decide how to assign depth 
ranges. 

" AnalyzeRangef)'* produces a percentage graph of 
depth values in a sei >, It helps determine if a suffi- 

ciently brge crunch value is being used. If depth vatui 
concentrated in the low ernl of middle ol the depth range, the 
crunch value is probably adequate, If a large percentage of 
depth values occupy the high end of the scale, the crunch 
factor should be increased for accurate computation. 

"MSetFiles" handles all disk input and output, All the 
procedures in this module prompt for a file name, open the 
file, read or write the data, and close the file, 
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"LoadColorAllocO " uses the procedures in 
MSetColors to create a color selection list. It reads a text h It 
with one color range specification per line. Each line contains a 
low depth value, a high depth value and a color register 
number The numbers can be separated by any non-numeric 
characters) except 8 sernkoton (";"), which indicates the resl od 
the line is a comment. 

I i • iJPaletteO" reads a similar text file. Each line 
contains a color register number (0-31), followed by red, green 
and blue color values (0-15). 

\1 ■otLoadedO" reads Mandelbrot set control data and 
copies it to the global variables in MSetData. 1 1 also reads a file 
containing the depth values and stores them in the depth 
array. "SaveMSetQ" writes the control and depth data to disk. 
All calculation data and results are saved and can be restored, 
making it possible to interrupt a computation, save it to disk, 
and restart it at a later lime. 

Every type of MSet data file has a unique suffix: 
" msdata" for control data, msdepth" lor depth information, 
".mspaletti 1 1 cations and " ■ for color 

allocations. All i peratians prompt fora filename, 

append the appropriate suffix, and read or write the filets). 

"MSet" is the main module. It contains the calculation 
routines and the program control togic. 

"CaleulatePointfJ" determines if a single coordinate 
pair (input as "i" and "j") are inside or outside the Mandelbrot 
set. 'Hie "\" and "j" inputs are applied to the equations "Xnew 
= x * * \ ■ " \ ■ - i" and "Ynew - 2 * x " \ • + j". The new "x" and 

itues ire substituted into the equations and they are 
recalculated until the "x" and "y" values blow up or the 
number of iterations exceeds the "crunch" value. The iteration 
count when a termination condition is reached is returned as 
"depth", 

"CalculateMSetO" controls the calculation of a 
complete Mand | If the flag variable "newCalcutation" 

is true, the control \ ,n i.ihles, display and depth array are 
initialized and a new calculation is --Lined. Otherwise, an 
interrupted calculation is continued. For each point, the 
procedure computes < i mr-linite-, obtains depth from 
"CalculatePointi i determines the display color associated 
with that depth, plots the depth on the screen, and stores the 
depth value It a kej press is detected after a point has been 

^sed, we escape from the procedure and fall back into the 
command processing loop 

If the proportions of the set's X and Y limits don t 
match the computer screen, the display will be distorted. After 
the limits are entered, "Adjust Aspect Ha tioO" modifies the 
1 1 r tu al limits to be 3/4 of the horizontal limits, assuring a 
coned osped ratio. 

hsplayPicO" uses the data from the depth array 

. the entire screen .:• vs the calculation 

parameters at the top of the screen. 

The rest of the procedures are all menu processors 
They display asetof options, obtain a command character 
from "GetChar()" and call the appropriate procedure. 

Set The Controls For The Heart Of The Sun 

Table 1 outlines MSet's controls. To avoid complicat- 
ing the program with Intuition code, a simple character-based 



Table One 



MSet 

A - Analyze 

D * Depth 

R - Range 
C - Calculate MSet 
D - Disk Operations 

A - Load Color Selection 

L- Load MSet 

P - Load Palette 

S - Save MSet 
K - Color Palette 

D - Depth Palette 

R - Rainbow Palette 
N - Set Up New Calculation 
O - Restore Old Parameters 
P - Enter Parameters 

x - Xmin 

y - Ymfn 

X - Xmax 

Y - Ymax 

C - Crunch 

A - Accept 

Q-Qult 
Q - Quit 

R - Redraw Current MSet 
S - Color Selection 

A - Amazing Computing 3 

N - Set Number of Colors 

P - Equal Point 

R - Equal Range 

Command? 



interface is used. If the program is run from a console window, 

indow created hy the "Kim Main Module" function 
of the Benchmark editor, it is controlled by single keypress 

ds. If MSet is run from the Shell or CLI, the "Return" 
key must be pressed to send keystrokes to the program. Since 
commands are entered into a Workbench window and graphic 
output occurs on a custom screen, it is necessarv to use the 
I eft Amiga-m key (the Arnica "Toggle Screen" function) to 
switch between control and display screens. 

Most ol the commands invoke procedures which I 
have already discussed. These should be self-explanatory. I'm 
going to describe a few of the less obvious unit nil functions 
and demonstrate how -omc of the MSet features are used 

"Enter Parameters" is used to enter or modify X and 
Y limits and the crunch value. If the parameters are accepted, 
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the new coordinates are drawn on the disput) screen. It I 
coordinates will fit within the current display, the "limit 
rectangle", which shows the new limits, is also drawn (Figures 
2A thru 2E). 

"Restore Old Parameters" resets the control vai 
to the previous limits and crunch value 

"Calculate M" t a calculation, 

current control parameters. If the calculation is partially 
completed, it will be continual , starting from the point where 
it was interrupted. 

"Set Up New Calculation" resets the control variables 
to start the calculation from the beginning. 

"Redraw Current MSet" redraws the screen using the 
current depth data. I his a mainly used to clear the limit box 
from the display screen. 




The first conversion step was to reduce the number of 
ted eight colors with the "Set Number of Colors' 
function and picked the "Equal Point" algorithm from the 
"Color S-U'i Hon" menu. This produced an eight-color display 
with the various zones in the set clearly delimited. 

1 saved the display screen as an IFF Hie and loaded 
the picture into Deluxe Paint IV to experiment with the colors. 
I could have used the "Load Palette" function and mv text 
editor to adjust the colors, but Deluxe I -■ much faster. 1 

chose alternating light and dark lei els ol pay to highlight the 
boundaries between the /ones and to make the headings I 
1 over color 0) stand oul. 

When I had found a satisfactor) I oloi set, I entered 
the red, green and blue values from the IJeluxe l'<iint color 
requester into a text file (Table 2). Then I used "Load Pah 



The only display mode 
MSet supports is low 
resolution (300x200). This 
provides the maximum 
number of colors and 
eliminates the 
complication of writing 
code to support multiple 
resolutions. 



"Set Number of Colors" controls the number of colors 
used in the algorithms which select colors I tte Willi 

depths. 



Shades Of Gray 

The Illustrations were created using MSet7, an 
advanced version of the MSet program, because it displays the 

calculation time fbf a set and can save a screen as an IFF file. 
See the note at the end of this article for more information 
about MS 

The Amiga is a color computer, but AC'S TECH is 9 
black-and-white publication. To avoid the problems of 
reproducing intricately detailed 32-color pictures in this 
format, I converted the illustrations to eight shades of gray. 

Reducing the number of colors produced An une> 
pected benefit. Removing extraneous detail made the overall 
structure of the pth more apparent 

Let's go over one of the conversions. I started by 
loading "BaseS'f (Figure I ). which had been calculated 
earlier and saved. 



to sel the Ms-t .. ulors [ his palette was u^ed for all the illustra- 
tions 

"1 oad Color Si could have been used instead 

ol "I qua] Point" 1 his would h.n e been desirable if I had 
wanted the same colors assigned to the same depth ranges in 
: i h image, rathei than the best fit of colors to depths fo- 

iu.il image table 3 shows a color selection file opti- 
mized tor the base set. 

Nothing But Zooms 

i igun - ZA thru 21 demonstrate the general proce- 
ilim- for finding interesting areas oJ the set, Each image is a 
I lose up of the rectangular area shown in the previous picture 
Some of the details in the original 32 color screens aren't visible 
in the illustrations. 

The process is pretty simple; examine a low-magnift- 
set for something mat looks interesting and 
m in on it. The limit rectangle (Figures 2A thru 2E| will 

lexl zoom. Don't bother zooming 
into an area that's all lake. That will take a lot of computer time 
and reward you with a completely black screen 
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- enough theor) I e 
The area around the north bay of the b 
2A) contains .1 lot ol interesting detail, including a black dot. 
Areas containing black dots or blobs are gixid candidal) - Itof 
zooms. 

Figure 2B stun 1 zoom. Some of the detailed 

structure of tt- iiind the ba) is revealed and 

the black dot has expanded into an irregular oval. 

A zoom into the area surrounding the oval produces 
Figure 2C A version of the bi 

le Figure 2D is a close-up of the newh -rei ealed lake. At 
this magnification, the edges of the lake are getting a bit 1 
Many of the po Hie lake have coordinates which Will 

eventually blow 1151, but the calculations are cut off by the 
crunch limit of 500. Fo I used a crunch w 





8 Level Gray Scale Color Allocation 


low depth. 
000, 


high depth. 


color 


001, 


00 


002, 


003, 


01 


004, 


004, 


02 


005, 


008, 


03 


006, 


007, 


04 


008, 


013, 


05 


014, 


499, 


06 


500, 


500, 


07 


Table Two 



Convergence 

Even with its current magnification limits, \l- 
plenty of surprises. Zooming in on Ae other black blobs in 
re 2E revealed base images, rotated into orientations I've 

n before. The distinctive heart and curdles ol the base 
image aren't the only figures present in the Mandelbrot set, but 
I'll leave the others tor you to diso 

If you want to explore outside the "confines" of Hie 
classic Mandelbrot set, other equations can be used in the 
calculation procedure. Paul Castongua 1 tide gives two 

examples of interesting altem ions, 

Three highly technical books on fractals are Benoit 
Mandelbrot's own The Fractal Geometry of Nature (W. J I 
Freeman, 1982), The Beauty of I pringer-Verlag, iy«6) 

and The Science of Fractal Images (Springer- Verlag. 1988), both 





8 Level Gray Scale Palette 


color 


red 


green 


blue 


description 


00 


15 


15 


15 


White 


01 


03 


03 


03 


Gray 1 


02 


07 


07 


07 


Gray 3 


03 


11 


11 


11 


Gray 5 


04 


13 


13 


13 


Gray 6 


05 


09 


09 


09 


Gray 4 


06 


05 


05 


05 


Gray 2 


07 


00 


00 


00 


Black 
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500 for all the illustrations in this artid reates accuracy, 

crunch should be Increased foj tiighei magnifications 

I decided to do the nevt zoom below the south' 
bay because I saw another black dot in ths- are; 2E is 

the result. The black dot in the center has expanded into a 
cubistk version ol the base sel and si \ eral more black blobs 
'i, . e thai the sub-bay in the upper right corner 
has grown another • if its own. 

k blob in the center pri 
■ ■ 2F. V\e'\ ..■ returned to the base set, except the size ol this 
m is approximate!) one ten-thousandth of the original At 
this level of m, in, the base image would be Hi7 : 

(1,15 miles) acn 

This is the region where things start getting really 
interesting. It- also the point whi I the wall rhia 

image shows *i certain blockiness thai ( an*! be eliminated bv 
increasing the crunch value. Any further zoom will produce 
images thai Hook like thej were constructed out ol blocks 
(Figure 2GJ We have reached the accuraq limit ol theamgle- 
eion floating point REAL numbers that MSet uses. 



by H-O. Peilgen and Dietmar Saupe. A somewhat less chal- 
lenging work is Vie Am t by A. K. Dewdnej (W 
H. Freeman, 1988), author of the Scientific American "Computer 
Recreations " article that introduced Mandelbrot sets t 
genera] public (August 1985. pages 16-25). 

The best non-technical introduction to Fractals and 
Mandelbrot sets I he I'aul Castongua y's "Frv 

Fundamentals" series in /tmaiwy Computing (March, |ulv.. and 
October 1989; January and June 1990; April 1991) 

There are also Mandelbrot set video tapes, such as 
■thing Bui Zooms" (Art Matrix, P.O. Box 880, Ithaca NY 
14851) and "A Fractal Ballet" (The Fractal Stuff Company, P.O. 
Box 5202, Spokane WA 99205-5202). 

hunting, See you at the lake. 



iterous 
additional features is avaiiabie from she author. Full source code and 
an exe\ m arc included. § 

h ret u rn postage to i r r 5225 

Marymounl Drive, Austin, Texas 78* 
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All the source code and 

executable files for The 

Joy of (Sets can be found 

on the AC s TECH Disk. 



Please write to; 

Jim Olinger 

c/o ACs TECH 

P.O. Box 2140 

fall Piver, MA 02722-2140 
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Advanced Scripting 



A Login Utility 

by Douglas Vuim 



I hi- new features brought to the shell by System 2.0 
make AmigaDOS a unique language for string and file 
manipulation. With tvvo new commands written in C in our 
arsenal, we can create a login utility. This security device will 
prevent unwanted access to your machine and will allow 
user of your system to have a personalized environment to 
work in. 

TWO NEW COMMANDS 

code and raw read 

Listings One and Two are programs that fill in for 
commands AmigaDOS doesn't have. They were compiled 
usinjc Mali Dillon's I HI ! , but am Amiga C compiler should 
be sufficient. Compile using the residentiable switch: 

1> dec -r rawread <e -o rawread 
1> dec -r code.c -o code 

Place them in C: or anywhere in your search path — 
making them resident is even better, 

rawread reads in a single line from the console and 
can be set to echo what is typed, a dummy character, ^r 
nothing at all. Although the command set can usually be used 
to read in data, it does not work well from the RAW; can 
that our script will be running in, rawread will allow us to hide 
what is being typed when the user enters his/her passwOf d 
rawread is executed with one argument — ECHO, MASK, or 
I'll l\D. These switches will echo what is being typed, echo 
"#"s, or echo nothing, respectively. 

t code takes a string as an argument, and changes it 

into a very large number. We will use code to encrypt each 
user's password, code is nearly non-reversible; it is next to 
impossible to determine a password that matches the value 
that is output. 



NEW SCRIPTING TECHNIQUES 

Variables and $ 

Local variables are a new feature with AmigaDOS 2,0. 
Previously, environmental variables were stored in the ENV: 
director^', and manipulated with getenv and setenv, The 
problem with this method was that processes shared the same 
data, and scripts had to go to great lengths to ensure that their 
variables had unique names. ENV: variables are still supported 
in the same manner, but local variables remove much of the 
hassle while keeping data from prying eyes. 

Local variables are manipulated using the commands 
get and set. From the shell, enter set. You should see some- 
thing like this: 

process Is 

RC 

Result 2 

and possibly others that other programs have set up, 

process, RC, and Result! are variables maintained by 
the shell; they are always present, process contains the same 
process number as shown by the command status, RC is the 
return code of the last command — is success, i is warn, 10 is 
error, 20 is fail. Result2 contains the number of a special 
message that the command why uses to explain errors, l hese 
values are now available for the user to n.irse, instead of 
relying on the existing AmigaDOS commands such as why and 
fault. 

To set a variable, simply enter set with the variable 
name and its value: 

l> set myname foo 
1> set val 4 

l> set 

myname foo 

5 





val 4 

To retrieve a variable, use the command get. 

t mynaroe 
foo 
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F lowever. the use of get is limited. The $ operate! Is 
much more useful. To use a variable .is an argument, enter $ 
followed by the variable name 

1> echo Stir/name 

foo 

1> rename test Siryname 

To completely remove a variable, use (he command 
unset. 



i - set 




process 


« 


RC 





Result2 




val 


4 


1> unset val 




1> set 




process 


4 


RC 







Q 



Back quotes 

The backquote (*) (l bo ve t a b and left of 1 ) is 

probably the most powerful part of AmigaDOS 2.0, A string in 
backquoles on a command line is executed before the main 
command, and the backquoted string is replaced by its own 
output, An example 

1> break 'status connand^ blanker' 

The shell executes the command status 
command=blankcr first. This command returns the process 
number of the currently running program blanker — let's say 
it's process 6. status command =bianker' is replaced with "6", 
and the command executed is really this: 

1> hn 

ilu-. little gem sends a break signal toanj named 
program without previous work by the user. 

t his sort of command will come in very handy in our 
login script: 

1> set num 'code password* 



code password is executed first, and outputs an ugly 
number. The number is inserted into the command, and it 
becomes 

tet num 12341234 

The backquote method eliminates the need for 
schemes thai rely on PIPE:, and makes AmigaDOS code much 
more pleasant to create and easier to read 

Redirection and * 

Data redirection is not new to AmigaDOS 2,0, but 
deserves a quick review. When a program is executed from the 

i is given two data streams: one to ouput to, and one to 
input from. In C, these streams are better known as stdin and 
stdout. Both streams usually point to the window from which 
the command was run. However, these streams can be made to 
point to other files by using the greater than (>) and less than 
(<) symbols to specify files for output and input, respectively. 
For example, the command 

1> echo >t:temp "Testing" 

would not result in any text to be displayed The input file 
stream has remained on the window where it usuallv is, but 
the ouput stream has pointed to t:temp. If you examined the 
file t;temp, you would find that it contained 'Testing". 

The asterisk i ' i character, when used with redirection, 
designates the current windo rely necessary to specify 

the current window for input or output (it is implicitly 
established,) but the command raw read when used with 
backquotes presents a special problem. You would expect the 
command 

1> set logname 'rawread BLIND* 

to execute rawread, accept input, then use it as the second 
argument. However, it turns out that when using backquotes, 
no input stream is created for the inner command. So, in order 
to read from the current window, we must explicitly specify it: 

1> set logname 'rawread <* BLIND' 

This command will give rawread the input handle it 
needs. Without it, the command would hang forever, waiting 
for input 
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A Note About Quotes 

A complication that can occur unexpectedly when 
ariables and backquote piping is that .1 siring might 
contain a space in the middle- Consider this case: 



1> set 




foo 




• 




RC 


Q 


Res . 


G 


rho Sfoo 




arguj 





invalid or line too long 

What was actually executed 

1> echo key board 

The command echo won't accept more than one 
argumi -ni It vim were typing the command directl) 
would execute 

1> echo "key board" 

The same thing can be done with variables and 
backquote pipes: 



1> echo "Sfo 
1> set test 



' 



These force the output into one argument, ensuring 
successful execution. A good rule of thumb is to always 
enclose variables and backquoted commands in double quotes. 
Even if you expect the input to be continuous, put quotes 
around it so you won't be surprised later on. Of course, if you 
intend to pass more than one argument to a command, it is 
perfectly legal to leave the quotes out. 

THE SYSTEM LOGIN SCRIPT 

Directory Setup 

On your hard drive or boot disk, you will need a 
directory to contain all the user directories which will contain 
each user's personal files and scripts. This directory must have 
USERS: assigned to it — do this in s:startup-sequence along 
with your other assignments. 

Installing the Script 

Listing Three is the login script. This goes in your 5: 
director)' as system-login. Once you have your user directories 

set up as you like them, test the script by executing 



1> new: 
s: system- log in 



RAW j 40/50/2 






The login window will pop up, showing a message, 
the time, and a "login:" prompt. Enter your login name (the 
same as your home directory) and your password, and a 
newsheJI will be started u iih your user-login file. To logout, 
just ./nd .nil the programs you have started, and endcli your 



shell. If you wish ro end the login script, enter "exit" at the 
"login:" prompt, and the window wf|] , 

If you simply want to run this from the shell 
your system is hooted, an alias for the above command is all 
that is necessary. However, If restricting a 
Yuu'll wan! tin- startup-sequence (0 start system-login so thai 1". 
is the only window on the screen once your mac hine has 
booted up. This involves one last trick so we can get around 
the program iprefs, iprefs is usually run from the sfartup- 

-;.. .• to set up youi preferences It Iprefs needs to change 
something drastic, like the size or resolution of the workbench 
screen, it pops up a requestei asking yon u-. > :...-.,• all v, indows 
that aren't drawers. If the login window appears before the 
startup window closes, iprefs will never have a chain 
change the screen to your settings. To fix this, we need one 
short script that is called from startup-sequence that waits long 
enough for the startup window to close so iprefs can seize the 
moment and adjust the screen. I he script can then call our 
abo\ t" newshell command, and exit. 

1 his « ript [Listing Four) is called startup-wail IA itri 
startup-wait and system-login in the s: directory, the last step 
is to add 



. 






to the last line before endcli in your startup-sequence. 

When you reboot, iprefs may pop up a requester, but 
just wait. The startup window will disappear, iprefs will reset 
tilt screen, and aftei 1 few moments, the login prom] 
up, 

Eventually, vou may wish to remove any newshells 
or loadwbs irom startup-sequence so that system-login is the 
only flung on your screen when you boot up. However, the 
first time, leave something <l • running so that you'll have a 
backup in case the s* 

Hints 

Do lots of dry runs before you install the scripts in 
your startup-sequence! There's nothing worse than getting 
locked out of your system disk. 

Temporarily eliminate the failat command at the 
beginning of system-login so that any serious errors will 
terminate the script instead of locking you 

When working at the RAW: console outside of the 
login script, you cannot see what you type, and the return key 
does not function. Enter your commands slowly— delete is not 
supported — and press Control-J instead of return. 

This program will not keep users who already have 
access from messing with other user's files (at least not until 
AmigaDOS 3.0 arrives). How ei er, if you write user-login 
scripts carefully, you can gr. t menu d: 

ice to run a select few program*., some a personali/ed 

shell, and others the WorJdberK h. 

Use quote- around as many variables and backquote 
pipes as possible. 

Things to Add 

A logout script for each user isn't such a bad idea 
< an IconX icon or alias endtli to point to such 9 ■->. rip! 
Can you write a script to send mail between users? 
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Listing One 



Listing Two 
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Listing Four 









Lifting Five 
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Listing Six 
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Please write to: 

Douglas Thain 

c/o ACs TECH 

P.O. Box 2140 

Fall River, MA 02722-2140 
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Quarterback 5.0 



by Merrill Callaway 



Central Coasi Software, e division ot New Horizons 
Inc., has improved Quarterback with release 5.0,2. Quartet 
works with all AmigaDOS systems (1.2 to 2.04) and a 
500 to 3000. 1 tested it on an Amiga 3000 running System 2,04. 
Quarterback is one of the first and most indispensable pro- 
grams hard disk users should buy. Like car insurance, a 
reliable backup utility is an essential, and Quarterback has a 
deserved reputation for reliability and use* friendliness 

rterback can save you a world of hurt if your hard disk 
crashes ( v., ,•. | H as "optimizing" my hard disk when a 
lightning strike miles away tripped a power company circuit 
breaker The lights were i m !•■ , vnds, but that was 

long enough to commit 

I joll of panic, 
followed by several days 
of restoring the hard 
disk ] hadn't backed up 
recently You will be 
i h.inkful for the user 
friend liness of Quarter- 
back because restoring a 
hard disk is a stressful 
task, ask anyone who 

has endured it. I h.u 
accident made a believer 
out of me... in backing 
up frequently, and in 
using an Uninterruptible 
Power Supply (I use the 
American Power 
'•"'''■< :■• .mis "Smart 



Uses of a Backup Utility 

What does a backup program do? Jt safeguards your 
re contents of your hard disk to 
floppies, tape, removable media (floptical* or Syquest disk- 1, 
or even another hard drive. Theoretically, you could just copy 
every file on your hard disk to a corresponding file on a 
Huf py, and then you'd be able to restore (copy back to the 
hard disk) any files that were corrupted by a crash, mistakenly 
deleted, or whatever. What do you do, however, with those 
graphic files that are larger than a floppy's capacity? That's one 
°f mv '■' have Quarterback. Not only can Quarterback 

copy files larger than one floppy disk to several floppies, but it 
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copies all files so as to maximize efficiency. Quarter 
I'.u k has i is own disk formal thai ignores the disk 
capacity— it simply fills as much of the disk as it can 
and then asks for another disk. Quarterback's propri- 
etaiy formal splits md links (Ilea across one 01 more 
floppy disks, should the end of the disk come before 
the file has finished copying. Thus, there is no waste I 
floppy disk space. 

The Interface 

Since New Horizons took over Central Coast Soft- 
ware, they have made the already good Quarterback 
interface truly excellent. No one makes a nicer looking 
interface than New Horizons. The new Quarterback 
has crisp icons and tasty but businesslike colors. The 
interface functions well, too. One slick feature is that 
file "Alt" key changes the buttons to "alter- 
nate" functions. For instance, the "Alt" key changes 
the "Tag" button to a "Tag All" button. This prevents a 
cluttered interface, yet you must remember only "Alt" 
to get the alternate set. All functions have keyboard 
and function key shortcuts, too. A summary is given in 
the back of the manual 

File Catalogs 

Quarterback builds a catalog of files in the disk 
partition or drawer you select, and makes it easy to 
manipulate this catalog (running into the thousands of 
files on a large hard disk). You can "tag" {select) which 

and directories are to be backed up or restored, 
because you will not want to process all files even,' 
time. How do you know which files you should back 
up? It makes good sense to back up only those files 
that have changed since the last time you backed up 
your disk. Nils is called an "incremental backup." 

The Archive Bit 

AmigaDOS uses an "archive bit" that may be set by 
the AmigaDOS "protect" command or by clicking on 
the box next to "archived" inside a nl« irma- 

Hon window. You may ask Quarterback to set (or not 
set) the archive bit after a backup, but the archive bins 
always turned off automatically by AmigaDOS if the 
file is ever saved or written to. Quarterback recom- 
mends you choose and stick to one of two schemes for 
backup. Both schemes I and II start with a monthly 
"full backup" of every file on your hard disk to a set of 
disks called a "full backup set," in which you get 
Quarterback to set the archive bits of all files. Step 2 
ts in each scheme. 
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In Scheme I. von make a wcekk '•incremental 
backup" to an "incremental set" of disks (different from 
full backup set). Use the same "incremental set" of disks each 
week, and do not have Quarterback rel the archive bit 

In Scheme II, you use a different "incremental set" of 
dial - each week and get Quarterback to -.•.• the a rchive bit. 
Each scheme has advantages and disadvantages, as the manual 
explains in greater detail Scheme 1 uses only two sets of disks, 
but me incremental backups take longer, whereas Scheme II 
needs multiple sets of disks and takes a shorter time to back 
up. 

Backup Media 

If you have a large hard drive, a large number of 
floppies will be needed to back it up. Quarterback now 
supports streaming tape (and QB may control features such as 
rewinding the tape), It also supports removable media such as 
20 MB Flopticals. and 4-t or 88 MB Syquest removable car- 
tridges. Quarterback allows you to set the I/O buffer size for 
removable media backup, so if you have the memory to 
allocate, it can really fly! 

Compression 

Quarterback can compress your files by almost 50 
pen ent Compression ratios depend on whether the file is text 
executable, or whatever. You may select from 12- to 16-bit 
compression. The higher number rep r i eeffictenl 

compression at the expense of more memory and time re- 
quired to execute. On my 25 MHz A3000, backing up 1 1 .8 MB 
of mostly executable programs at 16-bit compression took 24 
minutes and used 9 floppies (13 without compression). 
C omprasatan time on an unaccelcr.u* J Amiga can be quite 
long. 

Report Generation 

Quarterback will generate ^n Archive Report for vou 
and save it bo disk or print it if you wish. The report format 
and what information to include is user settable. You may even 
add Session Information of \ our own 

Other Features 

When Quarterbac k catalog of files to 

back up, or loads a catalog from a backup set for restoring, 1 1 
automatically "tags" all files in the catalog, as only "tagged" 
files will be backed up or restored. You may override this 
feature with "tag filters" We h,i\ e seen that you may use this 
feature to exclude those file with tin ,m hive bit set. You may 
prefer to include or exclude files by date (after or before user* 
supplied dates), or by AmigaDOS pattern matching. The 
Quarterback Tag Filler accomplishes this. You may aba make 
and s Utomatk tag Bltef " Specific filters may be given 

names, and ,i . . d and loaded through the Tag Filter menu. 



Quarterback has a set of 45 ARexx commands which 
control Quarterback's functions remoti -I \ \ mi may write 
macros to do fully automatic backups (with tape or other 
media with large enough capacity). Shitted function keys may 
be used to launch 10 macros, and Quarterback's Macro menu 
rnav be edited to show your macro names. 

Password protection is available, as well as a rich list 
of preference se Kings I nder 2 04, Qua rterbac k su pports 
Appiconsand the roots menu on Workbench. The manual is 
well written, illustrated, and clear. It lacks an index, however, 
a shameful omission in any manual. 

Problems 

I found two errors . On my A3000 with four floppy 
drives, two of them outside, Quarterback gets "write errors" 
on DF3; the last floppy drive "daisy chained" to drive DF2: 
(which is connected to the Amiga). Physically swapping the 
two external drives proved thai five errors were coming from 
Quarterback as n was always address "DF3;" which got 
errors, regardless of which actual drive unit was attached 

Quarterback puts an entry in the Workbench Tools 
menu. Quarterback ] ibbets, a 

program that allows you to put ant/ program in the tools menu. 
Try to run more than one copy of Quarterback. They start OK. 
They close OK. 1 n to start Quarterback again; the svstem 
crashes. This doesn't happen if ToolsX is not running or if a 
second copy of Quarterback never starts. I'd like to see the 
capacity to turn off the Tools menu feature in Quarterback, 



Conclusions 

Quarterback is a superb backup program— att: 
reliable, and intuitive. As the song goes, "Backing up is so hard 
to do, bul Quarterback makes this chore as pleasant as it can 
get. 



Quarterback 5,0 

Central Coast Software 

P.O. Box 164287 

Austin, TX 78746 

(512)328-6650 

Please write to: 

Merrill Callaway 

c/o AC's TECH 

P.O. Box 2140 

Fall River, MA 02722-2140 
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Developer's 
Tools 



There's Gold In Them There Disks 



There is a treasure of Applications, 
utilities, information, and even complete 
manuals on programming the Amiga in one 
place — The Fred Fish Collection. The 
consistent high quality, detailed explana- 
tions, and predominately top-notch contents 
have made the Fred Fish Collection the first 
resource of thousands of Amiga users 
throughout the world. 

Mr, Fish has won numerous awards as 
well as the thanks and acclaim of the entire 
Amiga community in his efforts to be the 
master software anthologist for the Amiga. 
With disk number 720 just released, Fred's 
efforts are nothing less than astounding This 
huge collection of software contributed by- 
Amiga users and developers from all over the 
globe now numbers, more thm 3*000 
individual programs. The reason for the 
anthology was immediately apparent to Fred 
back in 1985 when he began to collect it The 
Amiga needed software, and the only way 
that the software could be developed was to 
share information. He created a few disks for 
himself and then shared them at a local 
Amiga user group meeting. His fellow 
Amiga users were extremely grateful and 
have been so ever since. (To hear more about 
Fred and the early days of the Amiga, please 
read Steven King's Interview with Fred Fish 
in the October 1992 issue of Amazing 
Computing For The Commodore Amiga.) 
Aside from the wide variety of 
programs, demonstration software, anima- 
tions, and more available in the Fred Fish 
Collection, there is also a large selection of 
programming tools and utilities. Dr. Patrick 

1 he author of the unique catalog 
system for Fred Fish disks called Cat Fish, 
has defined 15 different categories of 
programming tools and examples under the 
main title of programming, as well as 32 
separate categories in the utility section. This 
is in a field of 17 major categories with over 
140 total individual subcategories. WW1 
every category or subsection may be of 
interest to each programmer's work, the 
combined library is an arsenal of important 
tools. 

For this article, we have included some 
of the important files added to the library in 
the past few months. We have chosen from 



the programming and utilities sections as 

i by the Cat Fish system. WW i- I do 
not have room to reprint the entire collection 
of programs from the 720 disks now in the 
library, this quick list will give AC s TLCH 
readers some idea of the potential available 
in this collection. The descriptions are edited 
i ersfons of the description files written by the 
master Amiga sofbx tft anthologist himself, 
Fred Fish, and are available on the assorted 
disks. 

PROGRAMMING; ASSEMBLER 

ADevtl A complete development system for 

Motorola's 68HC1 1 processor, including I 

macro assembler, linker, librarian, 
downloadcr, and disassembler, Supports 
multiple source file and multiple relc 
segments per file, Binary only, Autrm 

Burton 717 

EZAsm Combines 68000 assembly language 
with parts of C, Produces highly optimized 
code, Uses C-like function calls (supports all 
2.04 functions), braces, 'else', 'id' support. 
and much more. Comes bundled with A68k 
and Blink, for a complete programming 
environment Version 1.7. Includes example 
source and executable files. Binary only. 
Author: foe Siebenmann 699 

IFFI.ib An easy-to-use Amiga library whir, fcl 
gives you some powerful routines for dealing 
with IFF hit's, especially ILBM files (pictures), 
AMIM files (animations}, and 8SVX files 

Bed sounds). It is written oomph 
assembler and is just 3K. Includes source and 
binaries for several example programs that 
use the library. Version 22.2 I 
Author Christian A. Weber 674 

Ninf o A disassembler for memory, boot 
blocks, objects, libranes, and executable*. 
Version 2.0, includes source. Author: Tony 
Preston 662 

PROGRAMMING: C 

CManual Five-disk distribution of one of the 
largest collections of documents, e m m p I es. 
and utilities in C for the Amiga. It consists of 
six manuals, with more than 40 ehapt* 
fully executable examples Complete wUh 
source code, .in.d several utilities and other 
goodies. The manuals describe how to open 



and work with Screens, Windows, Graphics, 
Gadgets. Requesters, Alerts, Menus, IOCMP, 
Sprite AmigarJOS, Low Level 

1 Sraphks Routines, elC. They also explain 
how to use your C Compiler and give you 
important information about how the Amiga 
works and how yam programs should 
designed. When unpacked, the manuals and 
examples nearly fill up twelve standard 

. Floppies '• Because of its 

size, it is distributed on five library disks, 691 
through 695. Author: Anders Bjenrv 

DebugUtils Some tools tor use in debugging 
-lions. When used with Enforcer and 
'.wall, they comprise an integrate 
that gives the programmer a powerful and 
flexible debugging aide. Author Mark Porter 
663 

Flex A replacement for the UNIX lex (lexical 
analy/er generator) program that is Lister 
than lex, and freely redistributable. Lexical 
analyzer generators are generally used in 
combination with ich h 

yacc or bis t front end a foi 

language compile I n tools Version 

2 : '< ~ Includes source. Author Jef Poskanzer, 
Vem Paxson. el al 704 

FontConvcnVr ' mdard font files 

into c hires that can be included 

directly in your program. Probably rv 
useful for people writing programs that take 
over the machine and thus do not have access 
to the standard fonts directory. Includes 
source, Author Andreas Bauro 644 

1 1 extract A complete header file reference 
I vi ir.iuins. structures, structure members 
and offsets, flag values, library contents, 
function definitions, registers, library 
etc, The data from a set of V 1 J Amiga 
e header files is packed into the 
included file 'headers./' for immediate 
n'fi'Tenceby Hexrract \ nsSon Vl,l, 
freeware. Includes part source. Author: Chas 
A Wyndham674 

Indent A C source code formatter/indenler. 

useful for cleaning up inconsis- 
tently indented code. Version 13. In. 
source. Aui I us, Amiga port by 

Carsti 672 
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Indent A C 9011ICC code form.itler/indenler. 
Especially useful for cleaning up inconsis- 
tently Indented 

source. Author: Various. Amiga port b\ 
Cars* 702 

PROG RAMMING: Miscellaneous 
F2C A program that translates Fortran 77 
source inb source. F2C lets one 

portably mix C and Fortran, and makes a 
large body of well -tested Fortran source code 
. i ' . 1 1 i -,v ironments. Amiga port 

(tone ' and includes libraries 

for use with SA5/C Includes full source m C 
A uthor; S. I Feld | M Gay, Mark 

mone, and N. L Schryer; Amiga port 
by Martin Hohl 675 

MPE A compiler tool for users of the 
V12anuga programming environment, MPE 
does the same job belter than your batch r 1 1 ■. ■ 
Vou on do everything with the mouse or the 
right Amiga key With this Modula-2 

an compile, 
link, and run your program. When there is an 
error, theeditur is Marled automatically Ymi 
can set all switches for M2C, M2L, and 
M2Make. Version 117. Binary only- Author. 
1 1 tnmerrnans 703 

SANA The official Commodore developer 
information package for the SAN A-tl 
Network Dei 

II spec, readme files, SANA-tl drivers for 
Commodore's A2065 (Ethernet) and A2060 
(ARC NET} boards, docs and includes. 
Author Commodore' Amiga Networking 
Croup 673 

TalinCodc A bunch of source code for 
demos, tests, and experiments, that the 
author wrote over a period of eight years, 
mostly for recreation or for general R&D for 
projects that never materialized. Includes 3-D 
techniques, a maze generator, logarithms, 
bade utility functions, DOS functions, 
random numbers, and much more. Includes 
source, mostly in assembly code. Author: 
David Joiner 716 

UTILITIES: ARex* 
Rexx Host Lib This is a shared library 
package to simplify the ARexx host creation 
management procedure, Rexx-message 
parsing is also included, making tt possible to 
control ARexx from programs such as 
AniLgaRASK (can you imagine AmigaBASIC 
controlling Amig.i HA | Version 37.1 . 
Updated tor use with Kickstart 2.0. Includes 
ln*C and assembly language. Author 
aiaf'QIsen' Barthel 682 

UTILITIES: Benchmarks 

DiskSpced A disk speed testing program 

ally designed to gn Bl 
accurate results of fee true disk performance 

of the disk under test. Automatically updates 
and maintains an ASCII database of disk 
results for tested disks. Version 4-2. Includes 
source in C. Author Michael Sin/ 665 



UTILITIES: Calculators 

ICalc A powerful calculator with many 

features, including user-defined variables 

and funeti^: programming 

constru. U'x number calculations and 

more. Has comprehensive instru.. 
numerous examples. Version 2,1a. Binary 
anl) source available from author. Author: 
Martin W.Scott 713 

UTILITIES: CL1 and CLI Shells 
AUSH A new command line interpreter, 
designed to replace the CBM shell. Features 
include file name completion, pattern 
expansion, expression compulation. 

Hid history, for. -done loops, and much 
more. Almost fully compatible with ARP or 
Commodore shel I 42, AmigaDOS 

KM support. Requires arp.library under 1.3. 
Binary only. Author: Denis Gounetle 706 

GMC A console handler with command line 
editing and function key support, CMC 
provide* extended command line editing, 
function key assignment in four b 

Jed command line history, online help 
for functions in the handler, and an iconify 
function. Also includes an output buffer 
(dump to printer and window l, filename 
completer, script function, undo function, 
prompt beeper, pathname in window title, 
close gadget for KS 2.0, etc Version 9,13. 
Shareware, binary only. Author: Goetz 

Mueller 683 

SKsh A ksh-hke i .It 1 1 foe the Amiga. Some 
of its features include command Substil 
shell functions, aliases, local variables, emacs 

Is command line editing, I/O 
redirection, pipes, UNIX style wildcards, a 
large variety of commands, and coexistence 
with scripts from other shells. Well docu- 
mented. Vi \i .-, features include 
real pipes, AmigaDOS 2.04 support, 
enhanced ARexx handling, and more. Binary 
only. Requires AmigaDOS 2.04. Author: 
Steve Koren 672 

UTILITIES: CLI Commands 
CUEjm A Xlcon style program. It allows you 
to execute a script from WB and is completley 
CLI compatible, because it is a CLI, Can use a 
real scripl tile m Like commands in its own 
K X 1 1 TYPES. Version 1.1. Includes source in 
(_. Author. Sylvain Rougier 649 

Install A replacement for the AmigaDOS 
Install command, with an Intuition front end 
Version 1.1. Includes source in assembly. 

Author: David Kinder 641 

Scan Program to scan file GCflta 
matches to one or more specified patterns. 
Claimed to search hard drives twice as fast as 
the best search programs currently available, 
and RAM drives five times faster than other 
ms Can optionally scan the contents 
of files in LZH and LHA archives. Supports 
searching for multiple patterns simulta- 
neously. Other features include extensive 
wildcard support, optional inverted pattern 



matching, recursive directory scanning, line 
search highlights of matching words with 
selectable color, and more. Version 1.0. 
Includes source. Author: Walter Rothe 670 

UTILITIES: Dir/File Displayed 
inmwiO A 'Programmer's Workbench'. 
Allows you to easily and conveniently move, 
copy, rename, and delete files and directories 
using the mouse. Also provides a method to 
execute either Workbench or CLI programs 
by double-clicking them or by selecting them 
from a ParM like Menu with lots of argu- 
ments. Version 2.04 Binary only. Author: 
Sylvain Rougier, Pierre Carrette 649 

DirWark A East, small, efficient, DirUblity. 
Configurable options and buttons, as well as 
all the usual features. Comes with external 
conti: don 1.51. 

Shareware, binary only. Author: Chris 
Hames670 

Du A very small (only 932 bytes) program to 
display the total disk space used by a 
directory and all its sub-directories. Version 
25, Enhancements include wildcards, totals, 
clearer output, plus the program can be made 
resident. Requires Kickstart 2.0- Endlli 
source in assembler, Author: Stuart Mitchell 
701 

SID A very comprehensive directory utility 
for the Amiga that supports at least a couple 
of dozen different commands for operating 
on hies. Version 2.0. Binary only. Author: 
Timm Martin 651 

UTILITIES; Disk Utilities 
Ami Back I V « of Ami-Back v2.Q, a 

nice backup utility for the Amiga. Features 
include backup to any AmigaDOS compat- 
ible device (such as floppies, removable hard 
disk*, fixed media hard disk, and tape 
drives), compression, no copy protection, 
configuration files, complete backups, 
incremental backups, selective backups, tile 

lion filter, setting of archive 
password protected backups, online help, 
AREXX support, etc. Demo version does not 
have restore. Version 2.0a. Binary only. 
Author: Moonlighter Software «$2 

EraseDtt k A small, fast program used to 
erase a disk by setting all bits on the disk to 
zero. Version 0.92, Binary only- Author; Otto 
Bemhart650 

FreeCopy FreeCopy is unlike most copiers in 
that it does not actually copy disks. It 
removes the protection so disks can easily be 
backed up with almost any program, and in 
some cases be installed on your hard drive, 
Version 1.8, Public domain, binar, only, 
Author: Greg Pringle685 

Zoom A fast and efficient floppy disk 
archiving utility based on the data compres- 
sion/decompression algorithms used by 
lh.libran, Ha\ an Intuition and a Shell 
interface, fully supports Kickstart 2.0, is able 
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Anyone Still 
Use BASIC? 



YES! ... it remains the most 
widely used Language in the 
world with thousands of new 
users each year, 

WHY? . . , because it is still 
the very best combination of 
programming power and pro- 
ductivity, True BASIC, from Kemeny & Kurtz, original cre- 
ators of BASIC, is the most sophisticated implementation of 
BASIC available. Now, for a limited time, you can buy 
our special Amiga version for only 515.00! 

You'll receive the Language, libraries for graphics and 
font support. DO files, script files, more than 30 demo pro- 
grams, and a 200+ page manual which provides you with an 
interesting introduction to modem BASIC programming. 

In addition, you'll receive information on the other pow- 
erful Subroutine Libraries and interesting how-to books 
and advanced manuals that are available at special prices. 

Call 800 872-2742 ~ffT t 

Special Limited Amiga Offer: ^"\ j 
Only *15.00 plus shipping. 

Ru.ni of Am.fi 500. 1000. 2000 * 3000 
ind Lh« 1 3 & 204 operating lyMnM 

^COMMERCE AVENUE < WEST LEBANON, MH037W.M0 l7*2Hil * FAX: 1103,296-7015 
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to add texts and l> I output 

files, knows 274 different bootblock viruses, 
includes a number of compression param- 
eters (such as encryption of the output file) 
and a lot more. Version 5.4. Binary only 
Author Olaf Olsen' Barthel 682 

UTILITIES: File Compressions 
LhA A very fast an hlver thai is compatible 
with MS-DOS LhArc VI. 13 and LHA V2 \\ 
as well as the Amiga LhAn I hA 'a very 
memory efficient, has been written with 
stability and reliability in mind, has carefully 
optimized compression and decompression 
routines, is multitasking reentrant and pure, 
handles multiple volume archives (registered 
version only), and more. Version 1.32. 

Shareware, binary only Author 
Bob*rg715 

P-Compress A compression program that 
produces smaller files faster than any > 
current genera I -purpose cruncher, using LZH 
compression algorithms Can handle single 
files, whole drawers, disks, or selected files- or 
types of files within drawers and disks 
Includes compression and decompn 
object hies which can be linked to your own 
programs to allow Ihem to access and output 
data in LZH format V its ion 2 A Freew 
binary only Author Chas A.Wvndham. LZH 
code by Barthel f Krckel 650 



P-FixLib A new P-Suite Utility that diverts 
calls to DOS library so that P-Compressed 
files are decompressed before being opened 

lifted! Any type of file, including icons, 
executable^ libraries, fonts, texts, etc. may be 
compressed. Effectively doubles the capacity 
of your disks. Version 1 2, freeware, binary 
OTU) Author; t had A Wyndham65Q 

P- Writer A tent editor with special facilities 
for inserting text color and style changes and 
for pri ; jslrated texts for P*Reader. 

Version 3.3. Freeware, binary only. Author 
Wyndham674 

PPLib A shared library to make life easy fat 
people who wish to write programs that 
support PowerPacker. Loading crunched files 
from C or assembly is made fast, short, and 
Release 1 .5, Includes example source. 
Author: Nico Francois 678 

UTILITIES: Icons and Pointers 
Icons Some Workbench 1 3 icons with a 
Workbench 2.0 3D look, They also look pretty 
good under 2 when S&mpLj run through one 

.'! the many icon remapping tools available. 
Author L. Guzman 708 

Makclcon Allows you to create any of the 
Workbench 2-0 default icons for anything, 

disks, projects, drawers, the works. Designed 



for people who work from the shell making 
disks that will ultimately run From the 

W oik bench Requires Workbench 2.0. Binary 

only Author: Robert I ang 719 

Update Icon A tool lo add icoat to riles and 

drawers which do no1 ul ! 

attached, to update the default Itnils and to 

the positions ol Icons Very hand 
installation scripts Requires Kit kstarl and 
Workbench 2,04 (or higher). Version L0, 
includes source in C Author Olaf 'Olsen* 
Barthel 688 

UTILITIES: Postscript Uses 
Post AnexccUenl PostScript inlerpreler for 
the Am ?s the full 

Isncu&KC Supports type 1 and type 3 fonts, 
screen output, hie output, and printer output. 
Requires Arp library V39+ and Con Man 
VI -3+ (only under Amiga DOS 1.3). Version 
1.7. Includes source in C Author: Adrian 
AylwardfrM 

UTILITIES: Printing 

APrf A freely redistributable printing 

for the Amiga, Features include a full 
Intuition interface, preview function, pa^c 
selection, margin setup, line numbering, an 
A Hew port, a multi-columns mode, 2,04 
system release support, and more. Includes 
I I ngbsri venaons Vn 

i i I'.inarvonlj Anrhoi: iVnis GOUAeUe 706 

DiskPrint A label database which prints and 

lisk labels for 3.5 and 5.2S disks, 
Primarily created as a combined database 
and print utility for H) disks, it includes 

i-uSC label library functions (like 
printing labels for a whole FD series in one 
turn or multiple print of one label) and labels 
for most FD disks which are available within 

mouse clicks. Features include a fast 
search routine, user-definable label layout, 
different label si/rs. intuition -based disk 

tory read-in, and a lot more. Very 
configurable. Works fine with every printer 
connected to tlie parallel port and Amiga IX >S 
I 2. 1 3, and 2.x. Version 351, Both English 
IP A I and NTSC) and German versions. 
Shareware, binary only. Author Jan Geissler 
685 

UTILITIES; Screens and Windows 
Hoot Pic Hoot IV allows you to install nearly 
any IFF picture that you like in place of the 
Workbench hand that appears after ■ 
and addition i Ml D-Moduk 

Version 2.1b, Include assembly 

Author: Andreas Ac kermann 718 

WindowTiler A Workbench 2.0 commodity 
for am ndows. Comes with many 

tool types lo help customize it Supports 
virtual screen users, tiling, cascading, 

exploding window s, eftl \ i [ i ■■ In m 2, 1 b , Binary 
only. Author; Dmi^ Dyei «% 
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UTILITIES; Tasks & Memory Pgms. 
ARTM Amiga Real Time Monitor displays 
and controls system activity such as tasks, 
windows, libraries, devices, resources, port-*, 
residents,, interrupts, vectors, memory, 
mounts, assigns, locks ird ware and 

res_cmds. Version 1.6. Shareware, binary 
only Author: Dietmar Jansen and I- | 
Mertens 652 

Free Display how much free space (by t'- h 01 
blocks) you have on any or all of your 
mounted disk volumes. Runs from CU only. 
Version 3 ,06, Free now searches your device 
lit it desired (under AmigaDOS 2.0+ only), 
Includes source. Author: Daniel J Barrett 713 

JM Job Manager is a utility which extends 
the AmigaDOS multitasking environment by 
providing features such as: allocation 
cycles in any ratio to multiple CPU bound 
■ses, default task priorities based on 
task name, task logging, system uptime 
reports, task CPU use and CPU % reports, 
task invocation times, and more. JM has very 
little impact on the system itself, Reqir 
AmigaDOS 2.04 or later, Includes 68000/20 
and 68030/40 versions. Version 1.1 New 
features include better task name detection, 
and an ARexx port, Binary only. Author 
Sieve Koren 647 

Notify A suite of Rexx programs that can be 
used to issue messages or run commands 
automatically on certain days and /or at 
certain times of day- Facilities are provided 
tor the adding, editing and deleting of 

. tld tor displaying the times and 
texts of pending messages. A chime program 
i-, in. iin.k'j to enable the time to be an- 
nounced at regular intervals. Version 1 ,02, 
Author. Michael Tanzer 652 

Syslnfo A program which reports interest- 
ing information about the configuration of 
your machine, including some speed 
Comparisons with other configurations, 
versions of the OS software, etc This 
program has been very popular with many 
users and has been fully updated to include 
many new functions, Version 2j69, Binary 
only, Author. Nic Wilson 642 

System Info A system configuration display 
program with an Intuition interface, 
Recognizes about 80 different product codes 
and about 40 manufacturer ID's. Displays 
information about all AutoConfig cards, all 
mounted drives, vectors, processor types, 
and other useful information. Version 2.0a, 
shareware, binary only. Author: Paul 
Kotenbrander 644 

UTILITIES: Text File Displayed 

\ port of a UNIX text file reader. It can 

pes, accepts multiple filenames, and 
iny convenient positioning commands 
for forward ami hvk'.vard movement, 
marking positions, etc Version 177.4- 
Includes source. Author: Mark Nudclman, 
port by Frank Busalacchi 718 



View A text display er with many controls 
and features including searches, hie request- 
ors, jump to editor, etc. Version 2,0, Includes 
source. Author Jan Van Den Baard 658 

UTILITIES: UNIX 

UnixUtils A collection of UNIX-like pro- 
grams for the Amiga. Includes head, tail, sort, 
strings, diff and find. The first four are 
original programs, find is derived from tree by 
Tomas Rokicki, diff is a port of the GNU 
version Includes source. Author Maurizio 
Loreti 663 

UTILITIES: User Interfaces 
Arq Replaces the standard system requesters 
with nice animated requesters to which you 
can also attach different sounds. Works uo 
AmigaDOS 1,3 or 2-0 to give all the normal 
system requesters a nice new look. Version 
1 .66. Binary only, Author Martin Laubach, 
Peter Wlcek, and Rene Hexel 665 

Black Hole A file deletion utility for v2.04 and 
greater of the operating system. When run, it 
pu!> an appicon on the Workbench screen. 
Any file/ drawer icons that are dropped on it 
will be deleted Double clicking on me 
appicon brings up an options window, 
Version LI, includes source, Author: Alan 
Singfield 662 

Gad Tools Box A program that lets you draw/ 
edit Gad Tools gadgets and menus and then 
generates me corresponding C or assembly 
code for you. Version 1.3, Includes source. 
Author Jan van den Baard 659 

NoDelete This program pops up a requester 
to alert you of a file deletion being attempted 
via DekteFUel i and allows you to accept or 
cancel it. This also pertains to any files von 
attempt to delete via 'delete'. Version 2.01. 
Includes Bounce, Author L" we Schuerkamp 
657 

ParM Parameter.! ble Menu. ParM allows you 
to build menus to run whatever program you 
have on a disk. ParM can run programs either 
m WorkBench or CLI mode. This is an 
alternative to MyMenu which can run only 
when Workbench is loaded. ParM can have 
it's own little window, can attach menus to the 
LLI window you are running it from, or to the 
Wl menus. | List lika MyMenu, Vendor 3 << 
Includes source in C Author; Sylvain Rougier, 
Pierre Carrette 649 

PopUpMenu A small program that ma 
possible for you to use pop-up menus with 
any program that uses standard intuition 
menus. Version 4-3. Includes source. Author: 
Martin Adrian 667 

W Blink WBLink adds an 'Appicon' to the 
Workbench 2.0 screen that creates a link to 
whatever hie or directory is dragged on top of 
it. This version fixes some bugs and lets the 
user specify where the icon will be placed. 

cm 110. Includes source. Author: Dave 
Schreiber 654 



UTILITIES: Miscellaneous 
Enforcer Detects /protects against 
memory hits. Compatible with all DOS 
\ vrsions and Amigas (requires a Me muni,' 
Management Unit or 68030 processor). The 
tow IK of memory and all areas that are not 
RA M a re protected r u hd C PU n -ads or 
writes. ROM is marked as read-only. Version 
2.8b, an update to version 2M on disk 474. 
Binary unh Author Uryce Nesbitt658 

I'jtchOS Enhances OS 2.04 with three new 
features: key board -shortcuts for menus while 
a stnng-gadgel is active. Us* 
AmigaDOS pattern matching, and input of 
any char by typing its ASCII-code on the 
numeric pad. Requires at least AmigaDOS 
2 04. Implemented as a commodity. Version 
1.00. Includes documentation in German and 

■h language. Author. Hartmut Stein / 
Bernstein Zirkel Sof tworks 706 

UTILITIES: Vims Check & Fixing 
AnttCicloVir A link virus detector that 
detects 25 different such viruses. Version I S 
Shareware, binary only. Author Matthias 
Gutt 710 

BoolX An easy-to-use boot, file and link 
virus killer. For use with Kickstart 2-0 only. 
Has lotsoi options to detect and Idll Amiga 
viruses, extensive manual, locale support and 
AmigaGuJde online help. Version 5.00. 
v only. Author. Peter Stuer 703 

LVD A first defense utility against file and 
linkviruses. It patches the LoadSeg vcctor(s) 
and checks every executable that comes 
along, Recognizes 33 file or so linkviruses, 
Version 1,73. Binary only Author: Peter Stuer 
703 

VirusChecker A virus checker that can 

check memory, disk bootblocks, and all disk 
files for signs of most known viruses. Can 
remember nonstandard bootblocks that you 
indicate are OK and not bother you about 
them again, Includes an ARexx port. Version 
6.06. Binary only, Author John Vetdthuis 680 



More Information: 

For a complete printed list of the Fred 
Election's programs, please see 
the latest issue of ACs GUIDE To The 
Commodore Amiga, In addition, each 
month Amazing Computing For The 
Commodore Amiga lists the latest disks 
received at press time 

Dr. Peter Bailey's Cat Fish Catalog is 
available In format for $10 

from ASCITEC, Amiga Science and Tech 
Users' Group, P. O. Box 201, L a 
CA 94023-0201, (415) %0 9399. 
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Should You? 



Amaze Them Every Month! 

Amazing Computing lor lite Commodore Amiga users 

who want to do more with their Amigas f rom Amiga beginners to adva 

ews, hints, mud 
i- expanding capabilities miga. Am 

s in touch with the latest new products and new achievements tor the 
Comn program- 

ming, business, product : presents the finest the 

Amiga has to OJfl I tidl inlon 

style, the i' Her value thai big. 



A Guide For Every Amiga User. 

Vmiga user on your gift 1 mation with a SuperSub 

ing and the world famous AC's GUIDE To The 
Commodore Amiga. AC's GUIDE (publish* 
listing tble for the Amiga. This 

dope Amiga is divided ami ci enced to 

provide accurate and immediate information or I tor the Amiga. 

the thousands of hardware and products 

GUIDE also contains a thorough list and index to the complete Fred Fish 
Collection as well as hundreds of othei distributable software s 

ei library should be without the lal j iUIDE, 



More TECH! 

1ECH For Tlie Commodore Amiga is an Amiga users ultimate technical 
magazine- AC's TECH carries programming and hardware techniques too la 
or involved to fit in Amoving Computing. Each quarterly issue comes complete 

with a companion disk and is .1 in 1 9 who are seriously 

Involved In understanding how the Amiga works, With hardware projects such 
eating your ov. scale digin 1 torials such as produc- 

ing a ray tracing progr^ J ECH is the pub 1 1c.1t ion tor readers to ham 

their Amiga to fulfill their dream s. 



Why Not? 

Amazing Computing and ACs TECH — 
So many reasons to subscribe, so many ways to save... 

1-800-345-3360 



• 




High 

Resolution 

Output 

from your AMIGA™ 
DTP & Graphic 
Documents 



You've created the perfect piece, now you're looking for a good service bureau for output. You want 
quality, but n must be economical. Finally, and most important ...you have to find a service bureau thai 
recognizes your AMIGA file formats. Your search is over. Give us a call! 

Well imageset j i nil VMH i \ graphic files to RC Laser Paper or Film at 2400 dpi (up to 154 Ipi \ at a 

-•inch competitive cost. Also available at competitive cost arc quality Dupont ChromaChcck " 
color proofs of your color separations/films. We provide a variety of pre-press sen ices foa the desktop 
publisher. 

Who are we? \\ e ai e a dh ision o\' PiM Publications, the publisher of Amazing Computing for the 
iMIGA. We have a staff that realty knows the AMIGA as well as the rigid mechanical 
requirements of printers/publishers. We're a perfect choice for AMIGA DTP imagesetting/p] 

services. 



We support nearly every AMIGA graphic & DTP formal 
formats, 

n. please call. 



i rv most Macintos A • hu/DTP 



For more information call 1-800-345-3360 

for the ■■ presentati 
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